Configuring Posit Connect with Custom Container Images

This example deploys Posit Connect using custom images instead of the default public Posit provided images.

There are a minimum of three images that Connect requires to function in Off-Host Execution mode. They are listed below with their cooresponding default public repositories.

Connect service container posit/connect
Content container posit/connect-content
Content init container posit/connect-content-init

Additional content containers may be added to provide more R, Python, and Quarto versions and other system dependencies. See the Content Execution Environment section in the Connect Admin Guide for more details.

To use this example you will need:

a license file or key
a ReadWriteMany POSIX compliant storage class for sharedStorage
a PostgreSQL database.

Kubernetes

Recommended for Connect 2026.04.0 and later.

Define content images with executionEnvironments. Changes take effect on every helm upgrade without requiring a pod restart or database reset.

values.yaml


# Using a license file with the helm chart:
# https://github.com/rstudio/helm/tree/main/charts/rstudio-connect#license-file
# If you would like to use a license key see this documentation:
# https://github.com/rstudio/helm/tree/main/charts/rstudio-connect#license-key
license:
  file:
    secret: posit-licenses # TODO: Change to the secret name in your cluster
    secretKey: connect.lic # TODO: Change to the secret key containing your Connect license

# Configures Connect shared storage
sharedStorage:
  create: true
  mount: true
  storageClassName: nfs-sc-rwx # TODO: Change to a RWX StorageClass available in your cluster
  # volumeName: connect-shared-pv-name # Only needed if PVs have been statically provisioned, in which case this will need to match the PV name.
  requests:
    storage: 100G

# Define the custom image for the Connect pod(s)
image:
  repository: ghcr.io/posit-dev/connect # TODO: Change to match your custom image repository
  tagPrefix: "" # New posit-dev/images-connect images do not use a tag prefix
  tag: "" # TODO: Change to match your custom image tag. By default when this is left blank the chart app version is automatically filled out.

launcher:
  enabled: false

backends:
  kubernetes:
    enabled: true # Required for Off-Host Execution mode (Connect 2026.04.0 and later)
    # Define the custom image(s) for the content pod(s) init container
    defaultInitContainer:
      repository: ghcr.io/posit-dev/connect-content-init # TODO: Change to match your custom image repository
      tagPrefix: "" # New posit-dev/images-connect images do not use a tag prefix
      tag: "" # TODO: Change to match your custom image tag. By default when this is left blank the chart app version is automatically filled out.

# Define the custom image(s) for the content pod(s).
# Unlike launcher.customRuntimeYaml, changes take effect on every helm upgrade
# without requiring a pod restart or database reset.
executionEnvironments:
  # TODO: Add custom images based on the below template
  - name: ghcr.io/posit-dev/connect-content:R4.5.2-python3.14.3-ubuntu-24.04 # TODO: Change to match your custom image repository
    title: "Custom Runtime" # TODO: Change to a descriptive title
    description: "Runtime with R 4.5.2 and Python 3.14.3" # TODO: Change to a descriptive description
    python:
      installations:
        - path: /opt/python/3.14.3/bin/python3 # TODO: Change to match the Python path available in your image
          version: 3.14.3 # TODO: Change to match the Python version available in your image
    r:
      installations:
        - path: /opt/R/4.5.2/bin/R # TODO: Change to match the R path available in your image
          version: 4.5.2 # TODO: Change to match the R version available in your image
    quarto:
      installations:
        - path: /opt/quarto/1.8.27/bin/quarto # TODO: Change to match the quarto path available in your image
          version: 1.8.27 # TODO: Change to match the Quarto version available in your image

# The config section overwrites values in Posit Connect's main
# .gcfg configuration file.
config:
  # Configures the Postgres connection for Posit Connect.
  Database:
    Provider: "Postgres"
  Postgres:
    # The URL syntax below is to utilize a PostgreSQL database installed
    # in the cluster as described in the Kubernetes Cluster Preparation
    # page of this guide. Change this URL if your PostgreSQL database is
    # setup externally or in a different location.
    URL: "postgres://connect@postgres.example.com:5432/connect?sslmode=disable"
    Password: "<PASSWORD>" # TODO: Remove this line and instead set the password during helm install with --set config.Postgres.Password=<your-postgres-password>.

Launcher

For Connect versions older than 2026.04.0.

values.yaml


# Using a license file with the helm chart:
# https://github.com/rstudio/helm/tree/main/charts/rstudio-connect#license-file
# If you would like to use a license key see this documentation:
# https://github.com/rstudio/helm/tree/main/charts/rstudio-connect#license-key
license:
  file:
    secret: posit-licenses # TODO: Change to the secret name in your cluster
    secretKey: connect.lic # TODO: Change to the secret key containing your Connect license

# Configures Connect shared storage
sharedStorage:
  create: true
  mount: true
  storageClassName: nfs-sc-rwx # TODO: Change to a RWX StorageClass available in your cluster
  # volumeName: connect-shared-pv-name # Only needed if PVs have been statically provisioned, in which case this will need to match the PV name.
  requests:
    storage: 100G

# Define the custom image for the Connect pod(s)
image:
  repository: ghcr.io/rstudio/rstudio-connect # TODO: Change to match your custom image repository
  tagPrefix: ubuntu2204- # TODO: Change to match your custom image tag prefix
  tag: "" # TODO: Change to match your custom image tag. By default when this is left blank the chart app version is automatically filled out.

launcher:
  enabled: true # Required for Off-Host Execution mode
  useTemplates: true
  # Define the custom image(s) for the content pod(s)
  # Note these are only used on the initial creation of the Connect cluster
  # with an empty database. Once Connect is running you should add environments
  # via the UI or Connect API. More information is available in the Admin Guide:
  # https://docs.posit.co/connect/admin/appendix/off-host/execution-environments
  customRuntimeYaml:
    name: "Kubernetes"
    images:
      # TODO: Add custom images based on the below template
      - name: ghcr.io/rstudio/content-base:r4.2.2-py3.11.3-ubuntu2204 # TODO: Change to match your custom image repository
        python:
          installations:
            -
              path: /opt/python/3.11.3/bin/python3 # TODO: Change to match the Python path available in your image
              version: 3.11.3 # TODO: Change to match the Python version available in your image
        r:
          installations:
            -
              path: /opt/R/4.2.2/bin/R # TODO: Change to match the R path available in your image
              version: 4.2.2 # TODO: Change to match the R version available in your image
        quarto:
          installations:
            - path: /opt/quarto/1.3.340/bin/quarto # TODO: Change to match the quarto path available in your image
              version: 1.3.340 # TODO: Change to match the Quarto version available in your image
  # Define the custom image(s) for the content pod(s) init container
  defaultInitContainer:
    repository: ghcr.io/rstudio/rstudio-connect-content-init # TODO: Change to match your custom image repository
    tagPrefix: ubuntu2204- # TODO: Change to match your custom image tag prefix
    tag: "" # TODO: Change to match your custom image tag. By default when this is left blank the chart app version is automatically filled out.

# The config section overwrites values in Posit Connect's main
# .gcfg configuration file.
config:
  # Configures the Postgres connection for Posit Connect.
  Database:
    Provider: "Postgres"
  Postgres:
    # The URL syntax below is to utilize a PostgreSQL database installed
    # in the cluster as described in the Kubernetes Cluster Preparation
    # page of this guide. Change this URL if your PostgreSQL database is
    # setup externally or in a different location.
    URL: "postgres://connect@postgres.example.com:5432/connect?sslmode=disable"
    Password: "<PASSWORD>" # TODO: Remove this line and instead set the password during helm install with --set config.Postgres.Password=<your-postgres-password>.