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 in docker-compose.yml 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 einer erfolgreichen Komposition 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 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
- 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.
Am Ende siehst du eine Nachricht wie:
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 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 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 Steuerungen oder programmatischen Zugriff auf Logto möchtest.
Hosting-Anbieter
Diese zuverlässigen Hosting-Anbieter bieten Ein-Klick-Installationsvorlagen für Logto. Mit einfach bereitzustellenden Diensten kannst du dein CIAM-System mit Logto in Sekundenschnelle einrichten und starten.
Ein kostengünstiger Cloud-Dienst mit kostenlosen Dev-Tenants für eine einfache Authentifizierungsintegration.
Eine selbst gehostete 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 die 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, 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. Der Kontoerstellungsprozess ist auf Benutzername und Passwort beschränkt.
Logto OSS (self-hosted) unterstützt keine Konfiguration mehrerer Administratoren. Für Teamarbeit und Projekte, die mehrere Admin-Benutzer erfordern, empfehlen wir Logto Cloud, das vollständige Teamverwaltungsfunktionen bietet.