Skip to content

bcdock auth login

bcdock auth login

Log in via email OTP - also handles first-time account creation

Synopsis

Authenticate using the email one-time password flow.

Works for both first-time signup and returning users. If your account does not exist yet it will be created automatically - no separate signup step required. (Access is currently invitation-only; use 'bcdock auth waitlist' to request an invite before running this.)

You will be prompted for your email address, then a 6-digit code sent to that address. A long-lived API key (bdk_...) is minted and stored in ~/.bcdock/credentials.json - no silent expiry.

For non-interactive use (CI, smoke tests, agents): pass --email and --otp together to skip both prompts. The OTP must already be known to the caller (Development mode accepts "000000" - see local-e2e.sh notes).

For CI/CD and agent use, prefer API keys: bcdock auth set-token

bcdock auth login [flags]

Options

      --email string   Email address (skips prompt)
  -h, --help           help for login
      --otp string     Pre-known OTP code - skips the interactive Code: prompt. Requires --email. Intended for smoke tests and agent flows; humans should leave this unset.

Options inherited from parent commands

      --api-url string     API base URL (overrides BCDOCK_API_URL env var)
      --no-color           Disable colored output
  -o, --output string      Output format: table, json, csv (default "table")
  -q, --quiet              Suppress non-essential output
      --timeout duration   Request timeout (default 30s)
      --token string       API token (overrides BCDOCK_TOKEN env var)

SEE ALSO