CLI Authentication

API Keys

The ZevCloud CLI authenticates using API keys — not your ZevID password.

Generating a Key

1. Go to Dashboard → Settings → Security
2. Scroll to API Keys
3. Enter a name (e.g., "My Laptop CLI")
4. Select a scope:
   • Full — all operations
   • Deploy — deploy, restart, view logs only
   • Read — list projects, services, deployments only
5. Click Generate Key
6. Copy the key immediately — it's shown only once

Login

zevcloud login

Paste the key when prompted. The CLI validates it and stores it locally at ~/.config/zevcloud.

Multiple Teams

If your API key has access to multiple teams, you'll be prompted to select one. Switch teams by running zevcloud login again.

Security

• API keys are stored locally in ~/.config/zevcloud
• Keys are never sent to third parties — only to the ZevCloud API
• Revoke compromised keys immediately from the dashboard
• Use Deploy scope for CI/CD to limit blast radius