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 ^26.0.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 Hilfsinformationen 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 verwenden 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, 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-Bereitstellungen​

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

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

Wenn gesetzt, deaktiviert die gesäte Passwort-Richtlinie beim Admin-Mandanten 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).

Das Flag gilt nur für den Admin-Mandanten. Die Passwort-Richtlinie des Standard-Mandanten bleibt unberührt und kann nach der ersten Admin-Anmeldung weiterhin über Admin-Konsole > Anmeldeerfahrung > Passwort-Richtlinie von dir gesteuert werden.

Ein-Schritt-Installation (empfohlen für frische OSS-Bereitstellungen):

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.