Deployments

Create, monitor, and manage deployments from the terminal.

Deploy

Bash
1createos 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

Bash
1# Deploy from a specific branch
2createos deploy --branch staging
3
4# Deploy a Docker image
5createos deploy --image myapp:v2.0
6
7# Deploy a specific project in CI
8createos deploy --project abc-123-def

List deployments

Bash
1createos deployments list

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

View logs

Runtime logs

Bash
1createos deployments logs

Real-time log streaming

Bash
1createos deployments logs -f

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

Custom polling interval

Bash
1createos deployments logs -f --interval 5s

Build logs

Bash
1createos deployments build-logs

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

Retrigger

Re-deploy from the same source:

Bash
1createos deployments retrigger

Cancel

Stop a running deployment:

Bash
1createos deployments cancel

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

Wake up

Resume a sleeping deployment:

Bash
1createos deployments wakeup

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.