paas CLI¶

Command-line interface for PaaS Platform.

Install¶

curl -fsSL https://runtime.di2amp.com/install-cli.sh | sh

Or build from source:

cargo build --release -p paas-cli
# Binary at: target/release/paas

Quick Start¶

paas login
paas apps list
paas apps create my-app
paas --app my-app deploy
paas --app my-app logs --follow

Commands¶

Auth¶

Command	Description
`paas login`	Authenticate (browser or --email/--password)
`paas logout`	Revoke session
`paas whoami`	Show current user

Apps¶

Command	Description
`paas apps list`	List all apps
`paas apps create <name>`	Create app
`paas apps info <name>`	App details
`paas apps delete <name>`	Delete app
`paas status`	Current app status

Deploy & Releases¶

Command	Description
`paas deploy`	Deploy from current branch
`paas deploy --image nginx:alpine`	Deploy specific image
`paas releases list`	List releases
`paas releases rollback <id>`	Rollback to release
`paas releases promote <preview-id>`	Promote preview to prod

Processes¶

Command	Description
`paas ps`	List running processes
`paas ps:scale web=2 worker=1`	Scale processes
`paas ps:restart [type]`	Restart process type
`paas restart`	Restart all processes
`paas burst`	Temporary burst capacity

Config & Secrets¶

Command	Description
`paas config set KEY=val`	Set config var
`paas config get [KEY]`	Get config var(s)
`paas config unset KEY`	Remove config var
`paas config edit`	Edit in $EDITOR
`paas config pull`	Save to .env file
`paas config push`	Load from .env file
`paas secrets set KEY=val`	Set secret
`paas secrets list`	List secret names
`paas secrets delete KEY`	Delete secret

Logs & Observability¶

Command	Description
`paas logs [--follow] [--lines N]`	Tail/stream logs
`paas metrics [--range 1h] [--kind cpu]`	CPU/memory metrics
`paas traces [--limit 20]`	Recent traces
`paas errors [--range 24h]`	Recent errors

Add-ons¶

Command	Description
`paas addons`	List add-ons
`paas addons:create database:standard`	Provision add-on
`paas addons:info <name>`	Add-on details
`paas addons:credentials <name>`	Connection credentials
`paas addons:backup <name>`	Trigger backup
`paas addons:destroy <name>`	Remove add-on

Domains & Previews¶

Command	Description
`paas domains`	List custom domains
`paas domains:add example.com --tls-auto`	Add domain
`paas domains:remove example.com`	Remove domain
`paas previews`	List preview envs
`paas previews:create <branch>`	Create preview
`paas previews:destroy <id>`	Destroy preview

Team & Billing¶

Command	Description
`paas team`	List team members
`paas team:invite <email> [--role member]`	Invite member
`paas team:invites`	Pending invites
`paas team:remove <member-id>`	Remove member
`paas plan`	Show billing plan
`paas usage`	Current usage
`paas invoices`	List invoices
`paas invoices:download <id>`	Download invoice PDF
`paas billing:breakdown`	Cost breakdown by app
`paas workspaces`	List workspaces
`paas workspaces:create <name>`	Create workspace
`paas workspaces:switch <name>`	Switch active workspace
`paas workspaces:current`	Show active workspace
`paas regions`	List available regions

Shell & Nixpacks¶

Command	Description
`paas ssh [--ps worker]`	SSH into process
`paas run <cmd>`	Run one-off command
`paas nixpacks`	Show Nixpacks config
`paas nixpacks:apply [file]`	Apply nixpacks.toml
`paas nixpacks:edit`	Edit config in $EDITOR

Global Flags¶

--api-url <URL>   API base URL [env: PAAS_API_URL] [default: http://localhost:8080]
--app <NAME>      App name [env: PAAS_APP] (or .paas-app file in cwd)
--json            Output raw JSON

API Reference¶

https://runtime.di2amp.com/v1/docs