Posit Connect container images

Container images for Posit Connect.

Prerequisites

Tool	Required for	Install
Docker	Running containers locally	Get Docker
Helm	Deploying on Kubernetes	Install Helm
kubectl	Deploying on Kubernetes	Install kubectl
Product license	Running Connect	Licensing FAQ, Request a trial license

Images

Image	Description	Docker Hub	GitHub Container Registry
connect	Provides the Connect application. This image is for all containerized deployments of Connect.	docker.io/posit/connect	ghcr.io/posit-dev/connect
connect-content	Provides the runtime environments for executing content deployed to Connect. This image is for Off-Host Execution (OHE) deployments on Kubernetes.	docker.io/posit/connect-content	ghcr.io/posit-dev/connect-content
connect-content-init	An init container for Connect that pulls runtime components into a shared volume. This image is for Off-Host Execution (OHE) deployments on Kubernetes.	docker.io/posit/connect-content-init	ghcr.io/posit-dev/connect-content-init

Posit publishes additional container images to Docker Hub and GitHub Container Registry.

Running the images

For local Docker, you only need the connect image. The connect-content and connect-content-init images are for Off-Host Execution (OHE) deployments on Kubernetes, where published content runs in separate pods from the Connect server.

See the Connect installation guide for full setup instructions.

Deploying on Kubernetes

Use the Posit Connect Helm chart to deploy on Kubernetes. These images are the default in chart versions >= 0.20.0; see the image migration guide if you are upgrading from an earlier chart version.

Content image tags follow the pattern R{r_version}-python{python_version}-{os}. Append -pro for images with Posit Professional Drivers. See the chart's executionEnvironments value for how to register content images for off-host execution.

Build

You can build Open Container Initiative (OCI) container images from the definitions in this repository using one of the following container build tools:

• docker buildx
• buildah
• podman

Each Containerfile uses the root of the repository as the build context.

PCT_VERSION="2026.07"

# Build the standard Connect image using docker
docker buildx build \
    --tag connect:${PCT_VERSION} \
    --file connect/${PCT_VERSION}/Containerfile.ubuntu2404.std \
    .

# Build the standard Connect image using buildah
buildah build \
    --tag connect:${PCT_VERSION} \
    --file connect/${PCT_VERSION}/Containerfile.ubuntu2404.std \
    .

# Build the standard Connect image using podman
podman build \
    --tag connect:${PCT_VERSION} \
    --file connect/${PCT_VERSION}/Containerfile.ubuntu2404.std \
    .

For builds using the bakery CLI, see the contributing guide.

Contributing

To build images with bakery or run the test suite, see the contributing guide. For image maintainers, the contributing guide also covers adding versions, updating dependencies, backporting to older versions, known footguns, and CI failure diagnosis.

Customizing images

Each image serves a different role. The right image to customize depends on what you want to change.

I want to…	Customize	Example
Install specific versions of R or Python (Kubernetes)	connect-content	common/R · common/python
Add system libraries that content packages need (Kubernetes)	connect-content	common/system-dependencies
Install R on the Connect server (local Docker)	connect (Minimal)	common/R
Install Quarto on the Connect server (local Docker)	connect (Minimal)	server/quarto
Configure a Python package index	any	Admin docs
Upgrade the Connect server version	connect + connect-content-init (keep in sync)	—
Add custom runtime components for off-host execution	connect-content-init	Custom container images

For detailed guidance and full example code, see the Connect extending examples.

Related repositories

This repository is part of the Posit Container Images ecosystem. For shared build tooling and CI workflows, see images-shared.

Share your feedback

We invite you to join us on GitHub Discussions to ask questions and share feedback.

Issues

If you encounter any issues or have any questions, please open an issue. We appreciate your feedback.

Code of Conduct

We expect all contributors to adhere to the project's Code of Conduct and create a positive and inclusive community.

License

Posit licenses these container images and associated tooling under the MIT License.