CreateOS CLI / Deploy from Terminal

Deploy Any Project from Your Terminal in 60 Seconds

Deploy GitHub repos, local directories, and Docker images to production with a single CLI command. CreateOS auto-detects your project type and streams build logs in real time.

$ createos deploy

How to deploy from terminal

Install the CLI

$ brew install createos

Single binary, no dependencies. Also available via curl installer for Linux.

Sign in

$ createos login

Opens your browser for OAuth. For CI, use createos login --token.

Link your project

$ createos init

Creates .createos.json in your directory. All commands auto-detect the project from here.

Deploy

$ createos deploy

Auto-detects project type. Streams build logs. Prints your live URL on success.

Flags and options

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

Examples

# Deploy from default branch

$ createos deploy

# Deploy a specific branch

$ createos deploy --branch staging

# Deploy a Docker image

$ createos deploy --image myapp:v2.0

# Deploy in CI pipeline

$ createos deploy --project $PROJECT_ID

Frequently asked questions

How long does deployment take?

Most projects deploy in under 90 seconds. The CLI streams build logs in real time so you can watch progress. Build times depend on your project size and dependencies.

What project types are supported?

CreateOS CLI supports three deployment methods: GitHub (VCS) projects deploy from the latest commit, upload projects zip and push your local directory, and Docker image projects deploy any image reference.

Can I deploy from CI/CD pipelines?

Yes. Use createos login --token for headless authentication and createos deploy --project $ID to deploy without interactive prompts. Add --output json for machine-readable output.

What happens if deployment fails?

The CLI prints the failure status and suggests running createos deployments build-logs to see what went wrong. You can fix the issue and redeploy with createos deploy.

Related guides

Deploy Docker Containers

Deploy any Docker image to production with a single command. No Dockerfile configuration, no container orchestration. Just the image reference and CreateOS handles the rest.

Read guide

CLI in CI/CD Pipelines

Automate deployments from GitHub Actions, GitLab CI, or any CI/CD system. Every CLI command supports non-interactive mode with --output json and --force flags.

Read guide

Get started with CreateOS CLI

$ brew install createos

Full documentation GitHub

100,000+ Builders. One Workspace.

Get product updates, builder stories, and early access to features that help you ship faster.

CreateOS is a unified intelligent workspace where ideas move seamlessly from concept to live deployment, eliminating context-switching across tools, infrastructure, and workflows with the opportunity to monetize ideas immediately on the CreateOS Marketplace.