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 diese sehen:
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.
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 diese sehen:
Schritt 1
Bereite eine PostgreSQL@^14.0-Instanz vor und verwende 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
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
- Wenn du Docker Hub verwendest, verwende
svhd/logto:latestanstelle vonghcr.io/logto-io/logto:latest. - Verwende
host.docker.internaloder172.17.0.1inDB_URL, um auf die Host-IP zu verweisen.
Schließlich wirst du eine Nachricht wie diese 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 diese 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.
Schaue dir Kernservice 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.
Ein kostengünstiger Cloud-Dienst mit kostenlosen Entwickler-Mandanten für 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 Kontrollpanel zur Verwaltung von Cloud-Servern mit Docker.
Vollständig verwaltete DevOps-Plattform zur Bereitstellung 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, stelle bitte auf Logto Cloud bereit. Danke!
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.