alpacon login

Log in to Alpacon. There are two login paths:

  • Alpacon Cloud: use the --workspace and --region flags, or run alpacon login with no arguments to be prompted interactively.
  • Self-hosted: pass your host as the HOST argument (for example, alpacon.example.com).
alpacon login [HOST] [flags]

For Alpacon Cloud login without an API token (-t), browser authentication is the default. The CLI opens the browser automatically and waits for you to complete sign-in. Use --no-browser only in headless environments (SSH, containers) where no browser is available.

The HOST argument is for self-hosted login only. Direct Alpacon Cloud URLs (such as myworkspace.us1.alpacon.io) and URLs with a path (such as alpacon.io/myworkspace) are not valid as a HOST argument. For Alpacon Cloud, use --workspace and --region instead.

Running alpacon login with no arguments reuses your saved workspace, or prompts for the workspace name and region if none is saved.

Options

  -u, --username string   Username for login
  -p, --password string   Password for login
  -t, --token string      API token for login
      --insecure          Skip TLS certificate verification
      --no-browser        Do not open the browser automatically
      --workspace string  Workspace name for Alpacon Cloud login
      --region string     Region for Alpacon Cloud login (e.g., us1, ap1)
  -h, --help              help for login

Examples

# Alpacon Cloud login (interactive)
alpacon login
 
# Alpacon Cloud login (non-interactive, for CI/CD or AI agents)
alpacon login --workspace myworkspace --region us1
 
# Alpacon Cloud login with an API token
alpacon login --workspace myworkspace --region us1 -t <api-token>
 
# Self-hosted
alpacon login alpacon.example.com
 
# Self-hosted with an API token
alpacon login alpacon.example.com -t <api-token>
 
# Self-hosted with username and password
alpacon login alpacon.example.com -u admin -p mypassword
 
# Self-signed certificates
alpacon login alpacon.example.com --insecure
 
# Headless environment only (no browser available)
alpacon login --workspace myworkspace --region us1 --no-browser
 
# Equivalent via environment variable (useful for CI/CD)
ALPACON_NO_BROWSER=1 alpacon login --workspace myworkspace --region us1
Last updated: