Skip to content

stratumctl login

Authenticate against a Stratum control plane + persist the token

Terminal window
stratumctl login [flags]

Performs POST /v1/iam/login + writes the resulting session token to ~/.stratum/config.yaml (mode 0600). Subsequent stratumctl invocations read the token from the file.

Required flags: –endpoint (URL of the control plane) + –email. If –password is not supplied, stratumctl prompts for it without echo. For scripting, set STRATUM_PASSWORD or pipe via stdin (the prompt is skipped when stdin is not a tty).

An account that still has its install-time password (the bootstrap admin right after an install) must choose a new one at its first sign-in: login asks for it (or takes –new-password / STRATUM_NEW_PASSWORD).

Terminal window
stratumctl login --email admin@cloud.internal
stratumctl login --endpoint https://192.0.2.240:8443 --email admin@cloud.internal --password "$PASSWORD"
Flag Type Default Description
--email string Operator email (required)
--new-password string A new password, used only if the account must change its install-time one (prompts if missing)
--password string Operator password (optional; prompts if missing)