Deploy a Docker image

A Docker Service runs a container image you already have. Use this when CI builds elsewhere, you run vendor images, or Git-backed App builds are not a fit.

PrerequisitesCopy Anchor Link

• An Application with a Worker Node attached (see Getting Started).
• Image name (and tag). For private images, a registry under Integrations.

1. Create a Docker ServiceCopy Anchor Link

1. Open your Application and target Environment.
2. Choose Create Service / Add new and pick Docker.
3. Set a name (lowercase letters, numbers, hyphens).

2. Set image and portsCopy Anchor Link

1. Enter the image reference (for example ghcr.io/org/app:tag).
2. For private images, select a linked registry account.
3. Set the ports your process listens on.
4. Add variables and volumes if needed.

3. DeployCopy Anchor Link

1. Save, then Deploy / Redeploy.
2. Check Deployment and runtime logs.

Expected outcome: The container starts on your Worker Node and the Service shows a successful Deployment.

App vs DockerCopy Anchor Link

If something failsCopy Anchor Link

• Deployment issues under Troubleshooting
• Docker registry integration under Integrations (auth failures)
• Logs under Deployments and Operations

Go deeperCopy Anchor Link

• Docker services
• Docker registry integration