CLI Commands

Authentication

zevcloud login

Authenticate with an API key. Interactive prompt — paste your key and select a team.

zevcloud logout

Remove stored credentials.

zevcloud whoami

Show current authentication status — team name, API URL, key prefix.

Projects

zevcloud projects

List all projects in the current team.

zevcloud projects

Services

zevcloud services [projectId]

List services. Optionally filter by project.

# All services across all projects
zevcloud services

# Services in a specific project
zevcloud services 6412b9be-13ef-469c-b451-311439a8a9cd

Deployments

zevcloud deploy <serviceId>

Trigger a new deployment. Polls for status and reports success/failure.

zevcloud deploy a1b2c3d4-...

The command will:

1. Trigger the deployment
2. Show build progress
3. Report when live (or if failed)

zevcloud redeploy <serviceId>

Alias for deploy — triggers a fresh deployment.

Logs

zevcloud logs <serviceId> [options]

View runtime logs from a service container.

# Last 100 lines
zevcloud logs a1b2c3d4-...

# Last 500 lines
zevcloud logs a1b2c3d4-... -n 500

# Follow (tail) logs
zevcloud logs a1b2c3d4-... -f

Options:

Flag	Description
-n, --lines <number>	Number of lines to show (default: 100)
-f, --follow	Follow log output (polls every 5s)

Environment Variables

zevcloud env list <serviceId>

List all environment variables for a service.

zevcloud env list a1b2c3d4-...

Secret variables show •••••••• instead of their value.

zevcloud env set <serviceId> <key> <value> [options]

Set an environment variable.

# Regular variable
zevcloud env set a1b2c3d4-... DATABASE_URL postgres://...

# Secret variable
zevcloud env set a1b2c3d4-... API_SECRET sk_live_... -s

Options:

Flag	Description
-s, --secret	Mark as secret (hidden in dashboard)

zevcloud env remove <serviceId> <envVarId>

Remove an environment variable by its ID.

Configuration

zevcloud config [options]

Configure CLI settings.

# Set custom API URL
zevcloud config --api-url https://api.zevcloud.net/v1

Options:

Flag	Description
--api-url <url>	Set the API endpoint

API Key Scopes

When generating an API key, you choose a scope:

Scope	Permissions
Full	All operations — deploy, manage services, read data
Deploy	Deploy, restart, view logs — no create/delete
Read	List projects, services, deployments — no modifications

Exit Codes

Code	Meaning
0	Success
1	Error (authentication, deployment failure, etc.)