CLI for ZAD (Zelfservice Applicatie Deployment) - the self-service Kubernetes deployment platform.
uv tool install git+https://github.com/RijksICTGilde/zad-cli.gitOr pin a specific version:
uv tool install git+https://github.com/RijksICTGilde/zad-cli.git@v0.1.0Or for development:
git clone https://github.com/RijksICTGilde/zad-cli.git
cd zad-cli
uv synczad config init # interactive setup: creates .env with API key and project IDOr create a .env file manually:
ZAD_API_KEY=sk-...
ZAD_PROJECT_ID=my-project
Then use the CLI:
zad deployment create staging --component web --image ghcr.io/org/app:v1.0
zad logs production
zad backup create production| Setting | Flag | Env var / .env |
Config file | Default |
|---|---|---|---|---|
| API key | --api-key |
ZAD_API_KEY |
- | - |
| Project | -p |
ZAD_PROJECT_ID |
- | - |
| API URL | --api-url |
ZAD_API_URL |
api_url |
production URL |
| Output | -o |
ZAD_OUTPUT_FORMAT |
- | table |
| No wait | --no-wait |
- | - | wait |
Precedence: flags > env vars / .env > config file > defaults
Use --no-wait to return a task ID immediately instead of waiting for async operations to complete. Check progress with zad task status <id>.
The config file (~/.config/zad/config.toml) is for settings that rarely change:
zad config set api_url https://staging.example.com/apiEvery command supports --output / -o: table (default), json, yaml.
zad metrics overview --output json | jq '.cpu_usage'zad config init, set, get, list, path
zad project list, status, refresh, delete, subdomains, check-subdomain
zad deployment list, describe, create, update-image, refresh, delete
zad component list, add, assign, delete
zad service types, add, delete
zad resource tune, sanitize
zad task wait, status, list, cancel
zad backup create, list, status, delete, namespace, database, bucket
zad restore list, project, backup, pvc, database, bucket
zad clone database, bucket, check
zad logs [DEPLOYMENT] [-c component] [-n lines] [--since 1h]
zad metrics health, overview, cpu, memory, pods, network, query
zad open project, portal, domains
zad version
uv sync
uv run pytest
uv run ruff check .
uv run zad --helpEUPL-1.2