Erste Schritte mit OSS

GitPod

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

Gitpod läuft

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
Speicher: 8 GiB
Festplatte: 256 GiB

Docker Compose
Docker
npm-init

Docker Compose CLI wird normalerweise mit Docker Desktop geliefert.

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 gebündelt haben, 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 wirst du eine Nachricht wie folgt sehen:

Schritt 1

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

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

Ordne die Container-Ports der Logto-Kern- und Admin-App zu, z. B. 3001:3001 und 3002:3002; und setze die folgenden Umgebungsvariablen für den 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 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

Führe den Container mit allen oben genannten Umgebungsvariablen aus:

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, verwende 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.

Schließlich wirst du eine Nachricht wie folgt sehen:

Voraussetzungen

Node.js ^18.12.0
PostgreSQL ^14.0

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.

Herunterladen und starten

In deinem Terminal:

npm init @logto@latest

Sobald du den Initialisierungsprozess abgeschlossen und Logto gestartet hast, wirst du eine Nachricht wie folgt sehen:

Kern-App läuft unter http://localhost:3001
Kern-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ß!

Verwendung einer alternativen URL zum Herunterladen

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 übergibt.

Konfiguration (optional)

Logto verwendet Umgebungsvariablen für die Konfiguration, zusammen mit der Unterstützung von .env-Dateien. Siehe Konfiguration für detaillierte Nutzung und vollständige Variablenliste.

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

Ein 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 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.

GitPod​

Lokal​