Skip to content

CLI command reference

Every cantila command, grouped by area. Run cantila help for the same set in your terminal, or cantila <command> with no subcommand to list whatever that command manages.

deploy, projects, create, env, keys, config, backups and whoami are the fully fleshed-out core flows. Many service-group subcommands mirror the public API and are filling in alongside their products — descriptions below reflect each group's purpose.

Projects and deploys

CommandPurpose
cantila projectsList your projects (alias: cantila ls).
cantila create <name>Create a project. --runtime static|node|python|php|go|ruby|docker (default node), --region fsn1|hel1|ash (default fsn1).
cantila deploy <id>Deploy a project; streams steps live. --no-stream to wait. Image flags below.
cantila logs <id>Show build and deploy logs.
cantila status <id>Project status, services, domains and recent deploys.
cantila open <id>Open the project's primary URL in your browser.
cantila rollback <id> <deploy>Roll back to a previous deployment.
cantila scale <id>Resize: --vcpu, --memory, --disk, --always-on, --instances, --min, --max.
cantila instances <id>Per-instance health view.
cantila metrics <id>Recent CPU / MEM / RPS samples for a project.
cantila previews <id>List live preview deployments; create <id> <branch>, destroy <id> <dpl>.
cantila troubleshoot <id> <dpl>AI analysis of a failing deployment.
cantila git connect <id> <url>Connect a repo. Also push, rotate-secret, disconnect.

Create a project

cantila create blog --runtime node --region fsn1

Deploy

# default: deploy from git, streaming each step
cantila deploy prj_abc123

# deploy a pre-built image
cantila deploy prj_abc123 --image registry.example.com/blog:latest

# build + push a local Dockerfile, then deploy
cantila deploy prj_abc123 --build . --registry registry.example.com/blog --tag v2 --dockerfile Dockerfile

--build requires --registry. Pass either --image or --build, not both.

Environment variables

CommandPurpose
cantila env <id>List a project's environment variables.
cantila env set <id> KEY=VALUESet a variable. --public disables masking; --scope production|preview|all (default all).

Set an env var

# secret by default, applied to all scopes
cantila env set prj_abc123 DATABASE_URL=postgres://...

# a public (unmasked) value, production only
cantila env set prj_abc123 PUBLIC_API_BASE=https://api.example.com --public --scope production

API keys

CommandPurpose
cantila keys listList API keys for the current account.
cantila keys create <name>Mint a new key. --scope read|deploy|admin (default deploy).
cantila keys revoke <id>Revoke an API key.
cantila whoamiShow which account and key the CLI is authenticated as.

Create a key

cantila keys create ci-pipeline --scope deploy

The raw key is printed once on creation. Copy it immediately — afterwards only its prefix is shown. Save it with cantila config set apiKey=<key>.

Backups

CommandPurpose
cantila backups <id>List point-in-time backups (deployment + env-var snapshot).
cantila backups create <id>Capture a backup. --note '<msg>'.
cantila backups restore <id> <bak>Re-apply env vars and roll back to the captured deploy.
cantila backups delete <id> <bak>Drop a backup from history.

Capture and restore

cantila backups create prj_abc123 --note "before the schema migration"
cantila backups restore prj_abc123 bak_xyz789

Service groups

These commands mirror the public API for each Cantila product. Run a group with no subcommand to list, or cantila help for the current subcommands.

CommandPurpose
cantila domainSearch, buy, list and attach domains.
cantila aliases <id>Manage mail aliases on a project.
cantila databasesList each project's auto-wired managed database.
cantila storageManage S3-compatible object-storage buckets (alias: cantila data).
cantila mailInbound mail, sending-IP pools and deliverability rollups.
cantila mailboxes <id>Manage hosted mailboxes on a project.
cantila smsInbound SMS across your numbers.
cantila numbersPhone-number marketplace — search, buy, port-in, transfer.
cantila voiceInbound voice calls across your numbers.
cantila otpIssue and verify SMS one-time passcodes.
cantila a2pA2P / 10DLC carrier brand and campaign registrations.
cantila automationsAutomation instances (n8n / OpenClaw) and their workflows.
cantila connectionsAccount-wide credential connections and the provider catalog.
cantila agentsCantila Agents brain — pending proposals, recent actions, pause / resume.
cantila nodesEnrolled compute nodes (Bring-Your-Own-VPS).

Account and platform

CommandPurpose
cantila accountsShow the account a key belongs to; provision tenants and sub-accounts.
cantila teamList, add, re-role and remove members on the current account.
cantila invitesMint, list and revoke one-time invite links.
cantila orgsList, switch and leave the orgs you belong to.
cantila billingPlan, metered usage, recent charges, Stripe portal and dunning status.
cantila costAI cost-optimiser recommendations.
cantila activityRecent events on the account. --limit N.
cantila configShow or set the CLI config. See CLI configuration.