Posit Package Manager Container Images

Container images for Posit Package Manager.

Note

These images are in preview as Posit migrates container images from rstudio/rstudio-docker-products. The existing images remain supported.

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 Package Manager	Licensing FAQ

Images

Image	Docker Hub	GitHub Container Registry
package-manager	docker.io/posit/package-manager	ghcr.io/posit-dev/package-manager

Additional Posit container images are published to Docker Hub and GitHub Container Registry.

Running the Image

The fastest way to get started is to pull and run a pre-built image.

• Posit Package Manager — Quick Start, configuration, and environment variables

See the Package Manager installation guide for full setup instructions.

Deploying on Kubernetes

Use the Posit Package Manager Helm chart to deploy on Kubernetes. These instructions work for both ARM and x86_64 (AMD64) Kubernetes nodes.

helm repo add rstudio https://helm.rstudio.com
helm repo update

Create a Kubernetes secret from your license file, then configure the chart in your values.yaml:

kubectl create secret generic posit-package-manager-license \
  --from-file=license.lic=/path/to/license.lic

image:
  repository: ghcr.io/posit-dev/package-manager
  tag: "2025.12.0"

license:
  file:
    secret: posit-package-manager-license

Install Package Manager with Helm:

helm upgrade --install package-manager rstudio/rstudio-pm --values values.yaml

See the full chart documentation for all available values.

Building from Source

You can interact with this repository in multiple ways:

• Build container images directly from the Containerfile.
• Use the bakery CLI to manage and build container images.
• Extend the functionality by using the Minimal base image (see examples).

Build

You can build OCI container images from the definitions in this repository using one of the following container build tools:

• buildah
• docker buildx

The root of the bakery project is used as the build context for each Containerfile. Here, the bakery.yaml file, or project, is in the root of this repository.

PPM_VERSION="2025.12"

# Build the standard Package Manager image using docker
docker buildx build \
    --tag package-manager:${PPM_VERSION} \
    --file package-manager/${PPM_VERSION}/Containerfile.ubuntu2404.std \
    .

# Build the minimal Package Manager image using buildah
buildah build \
    --tag package-manager:${PPM_VERSION} \
    --file package-manager/${PPM_VERSION}/Containerfile.ubuntu2404.min \
    .

# Build the minimal Package Manager image using podman
podman build \
    --tag package-manager:${PPM_VERSION} \
    --file package-manager/${PPM_VERSION}/Containerfile.ubuntu2404.min \
    .

Using bakery

The structure and contents of this repository were created following the steps in bakery usage.

Additional documentation:

• Configuration Reference — bakery.yaml schema and options
• Templating Reference — Jinja2 macros for Containerfile templates
• CI Workflows — Shared GitHub Actions workflows for building and pushing images

Prerequisites

Build prerequisites

• python

• uv

• docker buildx bake

• just

• gh (required while repositories are private)

• bakery

  just install bakery

• goss and dgoss for running image validation tests

  just install-goss

Build with bakery

By default, bakery creates an ephemeral JSON bakefile to render all containers in parallel.

bakery build

You can view the bake plan using bakery build --plan.

You can use CLI flags to build only a subset of images in the project.

Test images

After building the container images, run the test suite for all images:

bakery run dgoss

You can use CLI flags to limit the tests to run against a subset of images.

Related Repositories

This repository is part of the Posit Container Images ecosystem. To extend the Minimal image with additional languages or system dependencies, see the extending examples. 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 Container Images and associated tooling are licensed under the MIT License