Skip to content

Authentication

Use the CLI to authenticate with the Dreadnode platform and manage provider API keys for local agent runs. You can log in before launching the TUI or from inside the client itself.

Use dreadnode login for a saved platform profile, or /login from inside an interactive session.

You can authenticate with a browser-based device flow or by pasting an API key:

Terminal window
dreadnode login
Terminal window
dreadnode login <api-key>
Terminal window
/login

Use --server <url> to target a self-hosted platform instance:

Terminal window
dreadnode login --server http://localhost:3000
Terminal window
/login --server http://localhost:3000

You can manage multiple API keys for a single account via the REST API:

  • GET /api/v1/user/api-keys — list active keys
  • POST /api/v1/user/api-keys — create a new key (optional name)
  • DELETE /api/v1/user/api-keys/{key_id} — revoke a key

Use the /keys command to store provider keys used by generators.

Terminal window
/keys set <provider> <key>

Supported providers: anthropic, openai, google, mistral, groq, custom.

ProviderKey format (example)
anthropicsk-ant-...
openaisk-...
googleAIza...
mistralmistral-...
groqgsk_...
customcustom-...

Profiles store saved platform credentials under ~/.dreadnode and the most recent login becomes active.

To switch profiles, log in to another server or set the profile explicitly via the DREADNODE_PROFILE environment variable:

Terminal window
DREADNODE_PROFILE=dev.app.dreadnode.io dreadnode

If you are using a self-hosted deployment, connect your CLI session to the server URL:

Terminal window
/connect <url>