Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor: add hosting providers #966

Merged
merged 3 commits into from
Jan 14, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 83 additions & 0 deletions docs/logto-oss/get-started-with-oss.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@ description: Quick start guides for Logto open-source service (OSS) initializati
sidebar_position: 1
---

import LogtoIcon from '@site/src/assets/logto-logo.svg';
import CoolifyIcon from '@site/src/assets/oss-coolify.svg';
import DekployIcon from '@site/src/assets/oss-dekploy.svg';
import EasypanelIcon from '@site/src/assets/oss-easypanel.svg';
import ElestioIcon from '@site/src/assets/oss-elestio.svg';
import RailwayIcon from '@site/src/assets/oss-railway.svg';
import ZeaburIcon from '@site/src/assets/oss-zeabur.svg';
import TabItem from '@theme/TabItem';
import Tabs from '@theme/Tabs';

Expand Down Expand Up @@ -187,6 +194,82 @@ Logto uses environment variables for configuration, along with `.env` file suppo

_Check out [Core service](/concepts/core-service) if you want more advanced controls or programmatic access to Logto._

## Hosting providers

These reliable hosting providers offers one-click installation templates for Logto. With easily deployable services, you can set up and launch your CIAM system using Logto in seconds.

<DocCardList
items={[
{
type: 'link',
label: 'Logto Cloud',
href: 'https://cloud.logto.io',
description:
'A cost-effective cloud service with free dev tenants for easy authentication integration.',
customProps: {
icon: <LogtoIcon />,
},
},
{
type: 'link',
label: 'Coolify',
href: 'https://coolify.io/docs/services/logto/',
description:
'A self-hostable Heroku/Netlify alternative for easy app and database management.',
customProps: {
icon: <CoolifyIcon />,
},
},
{
type: 'link',
label: 'Dekploy',
href: 'https://docs.dokploy.com/docs/core',
description: 'Lightweight tool for deploying apps on your own infrastructure.',
customProps: {
icon: <DekployIcon />,
},
},
{
type: 'link',
label: 'Easypanel',
href: 'https://easypanel.io/docs/templates/logto',
description: 'A modern control panel for managing cloud servers with Docker.',
customProps: {
icon: <EasypanelIcon />,
},
},
{
type: 'link',
label: 'Elestio',
href: 'https://elest.io/open-source/logto',
description: 'Fully managed DevOps platform to deploy your code and open-source software.',
customProps: {
icon: <ElestioIcon />,
},
},
{
type: 'link',
label: 'Railway',
href: 'https://railway.com/template/07_f_Z',
description: 'Simplifies app deployment and infrastructure management.',
customProps: {
icon: <RailwayIcon />,
},
},
{
type: 'link',
label: 'Zeabur',
href: 'https://zeabur.com/docs/marketplace/logto',
description: 'Simplifies app deployment, scaling, and monitoring for developers.',
customProps: {
icon: <ZeaburIcon />,
},
},
]}
/>

Please note that we do not provide customer support for third-party service providers. To access our support channels, kindly deploy on [Logto Cloud](https://cloud.logto.io). Thank you!

## Create an account \{#create-an-account}

Once you have successfully hosted Logto on your server, click on "Create account" on the welcome page. Keep in mind that the open-source version of Logto only allows for one account creation during the initial launch and does not support multiple accounts. The account creation process is limited to username and password combinations.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@ description: Schnellstartanleitungen für die Initialisierung des Logto Open-Sou
sidebar_position: 1
---

import LogtoIcon from '@site/src/assets/logto-logo.svg';
import CoolifyIcon from '@site/src/assets/oss-coolify.svg';
import DekployIcon from '@site/src/assets/oss-dekploy.svg';
import EasypanelIcon from '@site/src/assets/oss-easypanel.svg';
import ElestioIcon from '@site/src/assets/oss-elestio.svg';
import RailwayIcon from '@site/src/assets/oss-railway.svg';
import ZeaburIcon from '@site/src/assets/oss-zeabur.svg';
import TabItem from '@theme/TabItem';
import Tabs from '@theme/Tabs';

Expand All @@ -18,7 +25,7 @@ Um einen Online-GitPod-Arbeitsbereich für Logto zu starten, <a href="https://gi
<img src={gitpodRunning} alt="Gitpod läuft" width="720px" style={{ borderRadius: '4px' }} />
</p>

Logto verwendet standardmäßig den Port `3001` für seinen Kerndienst und den Port `3002` für die interaktive Admin-Konsole.
Logto verwendet standardmäßig Port `3001` für seinen Kerndienst und Port `3002` für die interaktive Admin-Konsole.

Um deine Logto-Reise fortzusetzen, drücke Strg (oder Cmd) und klicke auf den Link, der mit `https://3002-...` beginnt. Viel Spaß!

Expand All @@ -34,10 +41,10 @@ Die minimal empfohlenen Hardwareanforderungen für das Hosting von Logto sind:

<TabItem value="docker-compose" label="Docker Compose">

Docker Compose CLI kommt normalerweise mit [Docker Desktop](https://www.docker.com/products/docker-desktop).
Docker Compose CLI wird normalerweise mit [Docker Desktop](https://www.docker.com/products/docker-desktop) geliefert.

:::caution
Verwende unseren Docker Compose-Befehl nicht für die Produktion! Da wir derzeit eine integrierte Postgres-Datenbank zusammen mit der Logto-App in `docker-compose.yml` gebündelt haben, wird jedes Mal, wenn du den Befehl erneut ausführst, eine neue Datenbankinstanz erstellt, und alle zuvor gespeicherten Daten gehen verloren.
Verwende unseren Docker Compose-Befehl nicht für die Produktion! Da wir derzeit eine integrierte Postgres-Datenbank zusammen mit der Logto-App in `docker-compose.yml` gebündelt haben, wird bei jedem erneuten Ausführen des Befehls eine neue Datenbankinstanz erstellt, und alle zuvor gespeicherten Daten gehen verloren.
:::

```bash
Expand Down Expand Up @@ -92,7 +99,7 @@ Ordne die Container-Ports der Logto-Kern- und Admin-App zu, z. B. `3001:3001` un
TRUST_PROXY_HEADER: 1 # Setze auf 1, wenn du einen HTTPS-Proxy (z. B. Nginx) vor Logto hast
ENDPOINT: https://<your-logto-domain> # (Optional) Ersetze durch deine Logto-Endpunkt-URL, wenn du eine benutzerdefinierte Domain verwendest
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Optional) Ersetze durch deine Logto-Admin-URL, wenn du eine benutzerdefinierte Domain verwendest
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Ersetze durch deinen Postgres-DSN
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Ersetze durch deinen Postgres DSN
```

Führe den Container mit allen oben genannten Umgebungsvariablen aus:
Expand Down Expand Up @@ -131,7 +138,7 @@ Höhere Versionen funktionieren normalerweise, sind aber nicht garantiert.

Wir empfehlen die Verwendung einer neuen leeren Datenbank, die für Logto vorgesehen ist, obwohl dies keine zwingende Voraussetzung ist.

**Download und Start**
**Herunterladen und starten**

In deinem Terminal:

Expand Down Expand Up @@ -184,9 +191,88 @@ Logto verwendet Umgebungsvariablen für die Konfiguration, zusammen mit der Unte

</details>

_Schau dir [Kernservice](/concepts/core-service) an, wenn du mehr erweiterte Steuerungen oder programmatischen Zugriff auf Logto möchtest._

## Ein Konto erstellen \{#create-an-account}
_Schaue dir [Kernservice](/concepts/core-service) an, wenn du mehr erweiterte Steuerungen oder programmatischen Zugriff auf Logto möchtest._

## Hosting-Anbieter

Diese zuverlässigen Hosting-Anbieter bieten Ein-Klick-Installationsvorlagen für Logto. Mit leicht bereitstellbaren Diensten kannst du dein CIAM-System mit Logto in Sekundenschnelle einrichten und starten.

<DocCardList
items={[
{
type: 'link',
label: 'Logto Cloud',
href: 'https://cloud.logto.io',
description:
'Ein kostengünstiger Cloud-Dienst mit kostenlosen Entwickler-Mandanten für einfache Authentifizierungsintegration.',
customProps: {
icon: <LogtoIcon />,
},
},
{
type: 'link',
label: 'Coolify',
href: 'https://coolify.io/docs/services/logto/',
description:
'Eine selbsthostbare Heroku/Netlify-Alternative für einfache App- und Datenbankverwaltung.',
customProps: {
icon: <CoolifyIcon />,
},
},
{
type: 'link',
label: 'Dekploy',
href: 'https://docs.dokploy.com/docs/core',
description:
'Leichtgewichtiges Tool zum Bereitstellen von Apps auf deiner eigenen Infrastruktur.',
customProps: {
icon: <DekployIcon />,
},
},
{
type: 'link',
label: 'Easypanel',
href: 'https://easypanel.io/docs/templates/logto',
description: 'Ein modernes Kontrollpanel zur Verwaltung von Cloud-Servern mit Docker.',
customProps: {
icon: <EasypanelIcon />,
},
},
{
type: 'link',
label: 'Elestio',
href: 'https://elest.io/open-source/logto',
description:
'Vollständig verwaltete DevOps-Plattform zur Bereitstellung deines Codes und Open-Source-Software.',
customProps: {
icon: <ElestioIcon />,
},
},
{
type: 'link',
label: 'Railway',
href: 'https://railway.com/template/07_f_Z',
description: 'Vereinfacht die Bereitstellung von Apps und das Infrastrukturmanagement.',
customProps: {
icon: <RailwayIcon />,
},
},
{
type: 'link',
label: 'Zeabur',
href: 'https://zeabur.com/docs/marketplace/logto',
description:
'Vereinfacht die Bereitstellung, Skalierung und Überwachung von Apps für Entwickler.',
customProps: {
icon: <ZeaburIcon />,
},
},
]}
/>

Bitte beachte, dass wir keinen Kundensupport für Drittanbieter-Dienste anbieten. Um auf unsere Support-Kanäle zuzugreifen, stelle bitte auf [Logto Cloud](https://cloud.logto.io) bereit. Danke!

## Konto erstellen \{#create-an-account}

Sobald du Logto erfolgreich auf deinem Server gehostet hast, klicke auf der Willkommensseite auf "Konto erstellen". Beachte, dass die Open-Source-Version von Logto nur die Erstellung eines Kontos während des ersten Starts erlaubt und keine Unterstützung für mehrere Konten bietet. Der Kontoerstellungsprozess ist auf Kombinationen aus Benutzername und Passwort beschränkt.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@ description: Guías de inicio rápido para la inicialización del servicio de c
sidebar_position: 1
---

import LogtoIcon from '@site/src/assets/logto-logo.svg';
import CoolifyIcon from '@site/src/assets/oss-coolify.svg';
import DekployIcon from '@site/src/assets/oss-dekploy.svg';
import EasypanelIcon from '@site/src/assets/oss-easypanel.svg';
import ElestioIcon from '@site/src/assets/oss-elestio.svg';
import RailwayIcon from '@site/src/assets/oss-railway.svg';
import ZeaburIcon from '@site/src/assets/oss-zeabur.svg';
import TabItem from '@theme/TabItem';
import Tabs from '@theme/Tabs';

Expand Down Expand Up @@ -42,8 +49,7 @@ Los requisitos mínimos recomendados de hardware para alojar Logto son:
Docker Compose CLI generalmente viene con [Docker Desktop](https://www.docker.com/products/docker-desktop).

:::caution
¡No uses nuestro comando de docker compose para producción! Dado que actualmente tenemos una base de datos Postgres integrada junto con la aplicación Logto en `docker-compose.yml`,
cada vez que vuelvas a ejecutar el comando se creará una nueva instancia de base de datos, y cualquier dato persistido previamente se perderá.
¡No uses nuestro comando de docker compose para producción! Dado que actualmente tenemos una base de datos Postgres integrada junto con la aplicación Logto en `docker-compose.yml`, cada vez que vuelvas a ejecutar el comando se creará una nueva instancia de base de datos, y cualquier dato persistido previamente se perderá.
:::

```bash
Expand Down Expand Up @@ -95,10 +101,10 @@ docker pull svhd/logto:latest
Mapea los puertos del contenedor al núcleo de Logto y la aplicación de administración, por ejemplo, `3001:3001` y `3002:3002`; y establece las siguientes variables de entorno en el contenedor:

```yml
TRUST_PROXY_HEADER: 1 # Establecer en 1 si tienes un proxy HTTPS (por ejemplo, Nginx) frente a Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Reemplazar con tu URL de endpoint de Logto si estás usando un dominio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Reemplazar con tu URL de administración de Logto si estás usando un dominio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Reemplazar con tu DSN de Postgres
TRUST_PROXY_HEADER: 1 # Establece en 1 si tienes un proxy HTTPS (por ejemplo, Nginx) frente a Logto
ENDPOINT: https://<your-logto-domain> # (Opcional) Reemplaza con tu URL de endpoint de Logto si estás usando un dominio personalizado
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Opcional) Reemplaza con tu URL de administración de Logto si estás usando un dominio personalizado
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Reemplaza con tu DSN de Postgres
```

Ejecuta el contenedor con todas las variables de entorno anteriores:
Expand Down Expand Up @@ -145,7 +151,7 @@ En tu terminal:
npm init @logto@latest
```

Una vez que completes el proceso de inicio e inicies Logto, verás un mensaje como:
Una vez que completes el proceso de inicialización y comiences Logto, verás un mensaje como:

</TabItem>

Expand Down Expand Up @@ -192,9 +198,87 @@ Logto utiliza variables de entorno para la configuración, junto con soporte par

_Consulta [Servicio principal](/concepts/core-service) si deseas controles más avanzados o acceso programático a Logto._

## Proveedores de alojamiento

Estos proveedores de alojamiento confiables ofrecen plantillas de instalación con un solo clic para Logto. Con servicios fácilmente desplegables, puedes configurar y lanzar tu sistema CIAM usando Logto en segundos.

<DocCardList
items={[
{
type: 'link',
label: 'Logto Cloud',
href: 'https://cloud.logto.io',
description:
'Un servicio en la nube rentable con inquilinos de desarrollo gratuitos para una fácil integración de autenticación.',
customProps: {
icon: <LogtoIcon />,
},
},
{
type: 'link',
label: 'Coolify',
href: 'https://coolify.io/docs/services/logto/',
description:
'Una alternativa auto-hospedable a Heroku/Netlify para una fácil gestión de aplicaciones y bases de datos.',
customProps: {
icon: <CoolifyIcon />,
},
},
{
type: 'link',
label: 'Dekploy',
href: 'https://docs.dokploy.com/docs/core',
description: 'Herramienta ligera para desplegar aplicaciones en tu propia infraestructura.',
customProps: {
icon: <DekployIcon />,
},
},
{
type: 'link',
label: 'Easypanel',
href: 'https://easypanel.io/docs/templates/logto',
description: 'Un panel de control moderno para gestionar servidores en la nube con Docker.',
customProps: {
icon: <EasypanelIcon />,
},
},
{
type: 'link',
label: 'Elestio',
href: 'https://elest.io/open-source/logto',
description:
'Plataforma DevOps totalmente gestionada para desplegar tu código y software de código abierto.',
customProps: {
icon: <ElestioIcon />,
},
},
{
type: 'link',
label: 'Railway',
href: 'https://railway.com/template/07_f_Z',
description: 'Simplifica el despliegue de aplicaciones y la gestión de infraestructura.',
customProps: {
icon: <RailwayIcon />,
},
},
{
type: 'link',
label: 'Zeabur',
href: 'https://zeabur.com/docs/marketplace/logto',
description:
'Simplifica el despliegue, escalado y monitoreo de aplicaciones para desarrolladores.',
customProps: {
icon: <ZeaburIcon />,
},
},
]}
/>

Ten en cuenta que no proporcionamos soporte al cliente para proveedores de servicios de terceros. Para acceder a nuestros canales de soporte, despliega en [Logto Cloud](https://cloud.logto.io). ¡Gracias!

## Crear una cuenta \{#create-an-account}

Una vez que hayas alojado Logto con éxito en tu servidor, haz clic en "Crear cuenta" en la página de bienvenida. Ten en cuenta que la versión de código abierto de Logto solo permite la creación de una cuenta durante el lanzamiento inicial y no admite múltiples cuentas. El proceso de creación de cuentas se limita a combinaciones de nombre de usuario y contraseña.
Una vez que hayas alojado exitosamente Logto en tu servidor, haz clic en "Crear cuenta" en la página de bienvenida. Ten en cuenta que la versión de código abierto de Logto solo permite la creación de una cuenta durante el lanzamiento inicial y no admite múltiples cuentas. El proceso de creación de cuentas se limita a combinaciones de nombre de usuario y contraseña.

## Recursos relacionados \{#related-resources}

Expand Down
Loading
Loading