Login Command - ElizaOS Documentation

Usage

elizaos login [options]

Authenticate with ElizaOS Cloud using browser-based OAuth flow. On successful authentication, your API key is stored locally for use with other commands.

Options

Option	Description	Default
`-u, --cloud-url <url>`	URL of ElizaOS Cloud	`https://www.elizacloud.ai`
`--no-browser`	Do not automatically open browser	`false`
`--timeout <seconds>`	Authentication timeout in seconds	`300`

Examples

# Login with browser (default)
elizaos login

# The command will:
# 1. Open your browser to the ElizaOS Cloud login page
# 2. Wait for you to complete authentication
# 3. Store the API key locally

Without Browser

# Login without auto-opening browser
elizaos login --no-browser

# The command will display a URL to visit manually

Custom Cloud Instance

# Login to a custom ElizaOS Cloud instance
elizaos login --cloud-url https://custom.elizacloud.ai

Extended Timeout

# Allow more time for authentication (10 minutes)
elizaos login --timeout 600

Authentication Flow

Start: CLI initiates authentication request
Browser: Opens login page (or displays URL if --no-browser)
Authenticate: Complete login in browser (OAuth/credentials)
Callback: Browser sends token back to CLI
Store: API key is stored in ~/.elizaos/credentials

Environment Variable

Instead of logging in, you can set the API key directly:

export ELIZA_CLOUD_API_KEY=your-api-key

Or use the ELIZA_CLOUD_URL environment variable:

export ELIZA_CLOUD_URL=https://custom.elizacloud.ai
elizaos login

Credential Storage

After successful login, credentials are stored at:

Linux/macOS: ~/.elizaos/credentials
Windows: %USERPROFILE%\.elizaos\credentials

Troubleshooting

Browser Doesn’t Open

# Use --no-browser and copy the URL manually
elizaos login --no-browser

Timeout Issues

# Increase timeout for slow connections
elizaos login --timeout 600

Network Issues

If behind a proxy or firewall, ensure the cloud URL is accessible:

# Test connectivity
curl https://www.elizacloud.ai/health

# Then login
elizaos login

deploy: Deploy after authentication
containers: Manage containers (requires auth)

​Usage

​Options

​Examples

​Basic Login

​Without Browser

​Custom Cloud Instance

​Extended Timeout

​Authentication Flow

​Environment Variable

​Credential Storage

​Troubleshooting

​Browser Doesn’t Open

​Timeout Issues

​Network Issues

​Related Commands