The deploy command creates a new agent deployment or updates an existing one. It builds a deployment manifest with the provided parameters and monitors the deployment status until the agent is ready.

If the agent name already exists, you’ll be prompted to confirm the update unless the --force flag is used.

During deployment, the command will display a status panel showing the progress of the deployment and any conditions that need to be fulfilled before the agent enters the ready state.

​
Usage

pcc deploy [ARGS] [OPTIONS]

Arguments:

​
agent-name
string
required

Unique string identifier for the agent deployment. Must not contain spaces.

​
image
string
required

URL of the Docker image to deploy. Must be a valid Docker image URL. For example: docker.io/my-repo/my-image:latest.

Options:

​
--credentials / -c
string

Name of the image pull secret to use for accessing private repositories. The secret must be previously created using the pcc secrets image-pull-secret command.

​
--organization / -o
string

Organization to deploy the agent to. If not provided, uses the current organization from your configuration.

​
--secrets / -s
string

Name of the secret set to use for the deployment. The secret set must exist in the specified organization.

​
--min-instances / -min
number
default:"0"

Minimum number of instances to keep warm at all times. Default is 0, which means the agent will scale down to zero when not in use. Setting this to 1 or higher avoids cold starts.

​
--max-instances / -max
number
default:"10"

Maximum number of allowed instances for this agent. Must be between 1 and 10. If you need more instances, please contact us at help@daily.co or via Discord.

​
--force / -f
boolean
default:"false"

Force deployment and skip confirmation prompts. Use with caution.

​
Examples

Deploy a new agent:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.1

Update an existing agent with a new image:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.2

Deploy with a specific secret set:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.1 --secrets my-secret-set

Deploy a private image using image pull credentials:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.1 --credentials dockerhub-creds

Keep one instance always warm to avoid cold starts:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.1 --min-instances 1

Limit the maximum number of instances:

pcc deploy my-first-agent your-docker-repository/my-first-agent:0.1 --max-instances 5

​
Configuration TOML

The deploy command will look for any values declared in an adjacent pcc-deploy.toml file (documented here).

Values are applied with the following order of precedence:

  1. CLI arguments
  2. pcc-deploy.toml values
  3. Default values
authinit