Skip to main content
Don’t need your own registry? Cloud builds let you deploy directly from source with pipecat cloud deploy — no registry setup required.
When deploying agents to Pipecat Cloud, you can use images from both public and private container registries. While public images work out of the box, private images from any registry (including Docker Hub) require authentication setup.

​
Public vs Private Images

Public images from any registry, including Docker Hub, work with Pipecat Cloud without additional configuration. However, we strongly recommend using private images for better data privacy and security when deploying production agents. For Docker Hub specifically, even when using public images, we recommend setting up image pull secrets due to Docker Hub’s low rate limits for unauthenticated pulls. See our Docker Hub guide for setup instructions.

​
Private Registry Setup

For private images from any registry (including private Docker Hub repositories), you’ll need to configure image pull secrets for authentication. Choose your registry provider below for detailed setup instructions:

Docker Hub

Setup guide for Docker Hub, including access tokens and the build-push command.

Google Cloud Artifact Registry

Complete setup guide for GCP Artifact Registry, including service account configuration and authentication.

Amazon ECR

Detailed AWS ECR integration with automatic token refresh setup for continuous deployment.

​
General Process

All private registry integrations follow a similar pattern:
  1. Authenticate Docker with your registry locally
  2. Create image credentials in Pipecat Cloud using the CLI
  3. Reference credentials in your deployment configuration
  4. Deploy your agent using the private image
# Create image pull secret
pipecat cloud secrets image-pull-secret my-registry-creds https://your-registry-url
Then configure your pcc-deploy.toml file: 
agent_name = "my-agent"
image = "your-registry-url/my-agent:tag"
image_credentials = "my-registry-creds"
secret_set = "my-secrets"

[scaling]
    min_agents = 0
Finally, deploy: 
pipecat cloud deploy

​
Need Another Registry?

If you’re using a different container registry (Azure Container Registry, GitHub Container Registry, Harbor, etc.), the general process above applies. The main differences are typically in the authentication method and registry URL format. For assistance with other registry providers, please reach out on our Discord community.