Erste Schritte 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
- Docker
- npm-init
Die Docker Compose CLI ist normalerweise in Docker Desktop enthalten.
Verwende unseren Docker Compose-Befehl nicht für die Produktion! Da wir derzeit eine integrierte Postgres-Datenbank zusammen mit der Logto-App im docker-compose.yml-File bündeln,
wird bei jedem erneuten Ausführen des Befehls 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 erfolgreichem Aufbau siehst du eine Nachricht wie:
Schritt 1
Bereite eine PostgreSQL@^14.0-Instanz vor und verwende die Logto CLI, um eine Datenbank für Logto zu initialisieren:
- CLI
- npx
logto db seed
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 die 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
DATABASE_STATEMENT_TIMEOUT: DISABLE_TIMEOUT # (v1.36.0+) Deaktiviert statement_timeout für PgBouncer/RDS Proxy
Starte den Container mit den oben genannten erforderlichen Umgebungsvariablen (optionale sind unten ausgelassen; füge sie bei Bedarf hinzu):
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
- Wenn du Docker Hub verwendest, nutze
svhd/logto:lateststattghcr.io/logto-io/logto:latest. - Verwende
host.docker.internaloder172.17.0.1inDB_URL, um auf die Host-IP zu verweisen. - Wenn du PgBouncer oder RDS Proxy verwendest und die Meldung
unsupported startup parameter: statement_timeoutsiehst, setzeDATABASE_STATEMENT_TIMEOUT=DISABLE_TIMEOUT(ab v1.36.0).
Am Ende siehst du eine Nachricht wie:
Voraussetzungen
- Node.js
^22.14.0 - PostgreSQL
^14.0
Höhere Versionen funktionieren in der Regel, sind aber nicht garantiert.
Wir empfehlen, eine neue leere Datenbank zu verwenden, 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 Init-Prozess abgeschlossen und Logto gestartet hast, siehst du eine Nachricht wie:
Core app is running at http://localhost:3001
Core app is running at https://your-domain-url
Admin app is running at http://localhost:3002
Admin app is running at 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 bestimmte 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 zusätzlich .env-Dateien. Siehe Konfiguration für eine detaillierte Nutzung und die vollständige Variablenliste.
Schau dir Core Service an, wenn du erweiterte Steuerungsmöglichkeiten 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.
Ein kostengünstiger Cloud-Service mit kostenlosen Dev-Tenants für eine einfache Authentifizierungsintegration.
Eine selbsthostbare Heroku/Netlify-Alternative für einfache App- und Datenbankverwaltung.
Leichtgewichtiges Tool zum Bereitstellen von Apps auf deiner eigenen Infrastruktur.
Ein modernes Control Panel zur Verwaltung von Cloud-Servern mit Docker.
Vollständig verwaltete DevOps-Plattform zum Bereitstellen deines Codes und Open-Source-Software.
Vereinfacht die Bereitstellung von Apps und das Infrastrukturmanagement.
Vereinfacht Bereitstellung, Skalierung und Überwachung von Apps für Entwickler.
Bitte beachte, dass wir keinen Kundensupport für Drittanbieter-Dienste anbieten. Um auf unsere Support-Kanäle zuzugreifen, nutze bitte Logto Cloud. Danke!
Konto erstellen
Sobald du Logto erfolgreich auf deinem Server gehostet hast, klicke auf der Willkommensseite auf "Konto erstellen". Beachte, dass die Willkommensseite nur bei der ersten Inbetriebnahme die Erstellung eines Kontos erlaubt und der Kontoerstellungsprozess auf Benutzername und Passwort beschränkt ist.
Standardmäßig unterstützt Logto OSS (Self-Hosted) nicht die Konfiguration mehrerer Administratoren. Um weitere Mitglieder zu deiner Konsole einzuladen, installiere eine Self-Hosted-Lizenz und verwalte Mitglieder unter Tenant-Einstellungen > Mitglieder. Alternativ bietet Logto Cloud vollständige Teammanagement-Funktionen.
Verwandte Ressourcen
Umgang mit lokalem HTTPS-DevelopmentLogto großartige Community-beigetragene Ressourcen