Deployments

Create, monitor, and manage deployments from the terminal.

Deploy

createos deploy

The CLI detects your project type automatically:

VCS projects: deploys from the latest commit on the default branch
Upload projects: zips your local directory and pushes it
Image projects: deploys a Docker image

Flags

Flag	Description
`--project <id>`	Project ID (auto-detected from `.createos.json`)
`--branch <name>`	Branch to deploy from (VCS projects only)
`--image <ref>`	Docker image reference (image projects only)
`--dir <path>`	Directory to deploy (upload projects, default: `.`)

Examples

# Deploy from a specific branch
createos deploy --branch staging
 
# Deploy a Docker image
createos deploy --image myapp:v2.0
 
# Deploy a specific project in CI
createos deploy --project abc-123-def

List deployments

createos deployments list

Shows all deployments with version, status, URL, and timestamp.

View logs

Runtime logs

createos deployments logs

Real-time log streaming

createos deployments logs -f

Polls every 2 seconds. Press Ctrl+C to stop.

Custom polling interval

createos deployments logs -f --interval 5s

Build logs

createos deployments build-logs

Shows the build-time output (dependency install, compilation, packaging).

Retrigger

Re-deploy from the same source:

createos deployments retrigger

Cancel

Stop a running deployment:

createos deployments cancel

Use --force in CI to skip the confirmation prompt.

Wake up

Resume a sleeping deployment:

createos deployments wakeup

Interactive selection

When no deployment ID is provided, the CLI lists your deployments and lets you pick one interactively. In non-interactive mode (CI/pipes), pass the deployment ID via positional argument or use the --project and --deployment flags.