Build Commands

build

Create a new build for an application.

$ convox cloud build [dir] -a <app> -i <machine>

Options:

• --build-args: Build-time arguments
• --description: Build description
• --development: Development build
• --external: Use external builder
• --manifest: Manifest file (default: convox.yml)
• --no-cache: Disable build cache

Example:

$ convox cloud build . -a myapp -i production --description "Feature update"
Packaging source... OK
Uploading source... OK
Starting build... OK
Build:   BABCDEFGHI
Release: RABCDEFGHI

builds

List builds for an application.

$ convox cloud builds -a <app> -i <machine>

Options:

• --limit: Number of builds to show
• --watch: Watch for updates

Example:

$ convox cloud builds -a myapp -i production --limit 5
ID           STATUS    RELEASE      STARTED       ELAPSED  DESCRIPTION
BABCDEFGHI   complete  RABCDEFGHI   1 hour ago    2m       Feature update
BBCDEFGHIJ   complete  RBCDEFGHIJ   2 hours ago   3m

builds export

Export a build.

$ convox cloud builds export <build> -a <app> -i <machine>

Options:

• --file: Output file path

builds import

Import a build.

$ convox cloud builds import -a <app> -i <machine>

Options:

• --file: Input file path

builds info

Get information about a specific build.

$ convox cloud builds info <build> -a <app> -i <machine>

builds logs

View logs for a build.

$ convox cloud builds logs <build> -a <app> -i <machine>

Example:

$ convox cloud builds logs BABCDEFGHI -a myapp -i production
Building: .
Step 1/5 : FROM node:22
...
Successfully built abc123def456