Zum Hauptinhalt springen

Logto CLI

Logto CLI bietet eine bequeme Möglichkeit, deine Logto-Instanz zu installieren, zu warten und zu aktualisieren, ohne diese langweiligen technischen Aufgaben manuell erledigen zu müssen.

hinweis:

Aktuell liefern wir keine Binärdateien aus, daher wird Node.js ^22.14.0 in der Umgebung benötigt.

CLI global installieren​

Installiere über deinen bevorzugten Paketmanager, um den logto-Befehl global zu nutzen:

npm i @logto/cli -g

Du kannst immer --help anhängen, um die Hilfeinformationen zu jedem Befehl anzuzeigen:

logto --help
logto db seed --help

Lokale CLI​

Eine integrierte Version der CLI wird seit Logto v1.0.0-beta.11 mit jeder Logto-Version ausgeliefert. Angenommen, du hast bereits eine Logto-Instanz in ~/logto, dann kannst du die folgenden Befehle ausführen:

cd ~/logto
npm run cli # Lokale CLI aufrufen

Beachte: Wenn du Optionen übergeben möchtest, musst du ein -- VOR den Optionen für Logto CLI voranstellen, z. B.:

npm run cli db seed -- --db-url postgresql://your-database-url

CLI mit npx verwenden​

Eine weitere Möglichkeit, die Logto CLI zu verwenden, ist npx, womit ein Paket ohne Installation ausgeführt werden kann.

npx @logto/cli

Dies ist hilfreich für einmalige Aufrufe, z. B.:

npx @logto/cli db seed --db-url postgresql://your-database-url

Seed für air-gapped oder Offline-Deployments​

Seit Logto v1.40.0 akzeptieren sowohl die Befehle init (Installation) als auch db seed eine zusätzliche Option für Umgebungen, die während der Installation keinen Zugang zum öffentlichen Internet haben:

--disable-admin-pwned-password-check, --dapc

Wenn gesetzt, deaktiviert die gesetzte Passwort-Richtlinie beim Admin-Tenant standardmäßig die Have I Been Pwned (HIBP) Sicherheitsüberprüfung. Das bedeutet, dass das Erstellen des initialen Admins auf der Willkommensseite nicht mehr hängen bleibt, wenn api.pwnedpasswords.com nicht erreichbar ist (zum Beispiel in air-gapped Rechenzentren oder hinter strikten Egress-Firewalls).

Die Option gilt nur für den Admin-Tenant. Die Passwort-Richtlinie des Standard-Tenants bleibt unverändert und kann nach dem ersten Admin-Login weiterhin über Admin-Konsole > Anmeldeerfahrung > Passwort-Richtlinie von dir verwaltet werden.

Ein-Schritt-Installation (empfohlen für neue OSS-Deployments):

logto init --disable-admin-pwned-password-check

Bestehende Datenbank seeden (wenn Logto bereits extrahiert ist oder beim erneuten Seeden):

logto db seed --disable-admin-pwned-password-check

--dapc und --disable-admin-pwned-password-check sind Aliase; beide funktionieren.