Einstieg mit OSS

GitPod

Um einen Online-GitPod-Arbeitsbereich für Logto zu starten, klicke hier. Warte einen Moment, dann siehst du eine Nachricht wie:

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ß!

Lokal

Die minimal empfohlenen Hardwareanforderungen für das Hosting von Logto sind:

• vCPU: 2
• Arbeitsspeicher: 8 GiB
• Festplatte: 256 GiB

Docker Compose

Die Docker Compose CLI ist normalerweise in Docker Desktop enthalten.

vorsicht:

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 bündeln, wird jedes Mal, wenn du den Befehl erneut ausführst, eine neue Datenbankinstanz erstellt und alle zuvor gespeicherten Daten gehen verloren.

curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | docker compose -p logto -f - up

Nach einer erfolgreichen Komposition siehst du eine Nachricht wie:

Docker

Schritt 1

Bereite eine PostgreSQL@^14.0-Instanz vor und verwende die Logto CLI, um eine Datenbank für Logto zu initialisieren:

CLI

logto db seed

npx

npx @logto/cli db seed

Schritt 2

Ziehe das Image:

# ghcr
docker pull ghcr.io/logto-io/logto:latest
# DockerHub
docker pull svhd/logto:latest

Schritt 3

Mappe die Container-Ports auf Logto Core und Admin App, z. B. 3001:3001 und 3002:3002; und setze die folgenden Umgebungsvariablen im Container:

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 eigene Domain verwendest
ADMIN_ENDPOINT: https://<your-logto-admin-domain> # (Optional) Ersetze durch deine Logto-Admin-URL, wenn du eine eigene Domain verwendest
DB_URL: postgres://username:password@your_postgres_url:port/db_name # Ersetze durch deinen Postgres-DSN

Starte den Container mit allen oben genannten Umgebungsvariablen:

docker run \
  --name logto \
  -p 3001:3001 \
  -p 3002:3002 \
  -e TRUST_PROXY_HEADER=1 \
  -e ENDPOINT=https://<your-logto-domain> \
  -e ADMIN_ENDPOINT=https://<your-logto-admin-domain> \
  -e DB_URL=postgres://username:password@your_postgres_url:port/db_name \
  ghcr.io/logto-io/logto:latest

tipp:

• Wenn du Docker Hub verwendest, nutze svhd/logto:latest anstelle von ghcr.io/logto-io/logto:latest.
• Verwende host.docker.internal oder 172.17.0.1 in DB_URL, um auf die Host-IP zu verweisen.

Am Ende siehst du eine Nachricht wie:

npm-init

Voraussetzungen

• Node.js ^18.12.0
• PostgreSQL ^14.0

Höhere Versionen funktionieren in der Regel, sind aber nicht garantiert.

Wir empfehlen die Verwendung einer neuen, leeren Datenbank, die ausschließlich für Logto vorgesehen ist, auch wenn dies keine harte Voraussetzung ist.

Herunterladen und starten

Im Terminal:

npm init @logto@latest

Sobald du den Initialisierungsprozess abgeschlossen und Logto gestartet hast, siehst du eine Nachricht wie:

Core app läuft unter http://localhost:3001
Core app läuft unter https://your-domain-url
Admin app läuft unter http://localhost:3002
Admin app läuft unter https://your-admin-domain-url

Gehe zu http://localhost:3002/, um deine Logto-Reise fortzusetzen. Viel Spaß!

Alternative URL zum Herunterladen verwenden

Wenn du eine URL für die Logto-Zip-Datei angeben möchtest, verwende die Option --download-url. Zum Beispiel:

npm init @logto@latest -- --download-url=https://github.com/logto-io/logto/releases/download/v1.2.2/logto.tar.gz

Beachte, dass das zusätzliche -- erforderlich ist, damit NPM die Argumente weitergibt.

Konfiguration (optional)

Logto verwendet Umgebungsvariablen für die Konfiguration und unterstützt auch .env-Dateien. Siehe Konfiguration für eine detaillierte Nutzung und die vollständige Variablenliste.

Schau dir Core Service an, wenn du erweiterte Steuerungen oder programmatischen Zugriff auf Logto möchtest.

Hosting-Anbieter

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

Logto Cloud

Ein kostengünstiger Cloud-Dienst mit kostenlosen Dev-Tenants für eine einfache Authentifizierungsintegration.

Coolify

Eine selbst gehostete Heroku/Netlify-Alternative für einfache App- und Datenbankverwaltung.

Dokploy

Leichtgewichtiges Tool zum Bereitstellen von Apps auf deiner eigenen Infrastruktur.

Easypanel

Ein modernes Control Panel zur Verwaltung von Cloud-Servern mit Docker.

Elestio

Vollständig verwaltete DevOps-Plattform zum Bereitstellen deines Codes und Open-Source-Software.

Railway

Vereinfacht die App-Bereitstellung und das Infrastrukturmanagement.

Zeabur

Vereinfacht die App-Bereitstellung, Skalierung und Überwachung für Entwickler.

Bitte beachte, dass wir keinen Kundensupport für Drittanbieter-Dienste anbieten. Um auf unsere Support-Kanäle zuzugreifen, verwende bitte Logto Cloud. Vielen Dank!

Konto erstellen

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 beim ersten Start erlaubt und keine Mehrfachkonten unterstützt. Die Kontoerstellung ist auf die Kombination aus Benutzername und Passwort beschränkt.

tipp:

Logto OSS (self-hosted) unterstützt nicht die Konfiguration mehrerer Administratoren. Für die Zusammenarbeit im Team und Projekte, die mehrere Admin-Benutzer erfordern, empfehlen wir die Nutzung von Logto Cloud, das vollständige Teamverwaltungsfunktionen bietet.

Verwandte Ressourcen

Umgang mit lokaler HTTPS-Entwicklung

Logto großartige Community-Ressourcen