https://github.com/posit-dev/images-workbench
Posit Workbench Container Images
https://github.com/posit-dev/images-workbench
Last synced: 15 days ago
JSON representation
Posit Workbench Container Images
- Host: GitHub
- URL: https://github.com/posit-dev/images-workbench
- Owner: posit-dev
- License: mit
- Created: 2024-08-14T00:36:01.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-22T19:09:01.000Z (20 days ago)
- Last Synced: 2026-04-22T19:24:47.915Z (20 days ago)
- Language: Jinja
- Homepage: https://docs.posit.co/ide/server-pro
- Size: 284 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Posit Workbench Container Images
Container images for [Posit Workbench](https://docs.posit.co/ide/server-pro).
> [!NOTE]
> These images are in preview as Posit migrates container images from [rstudio/rstudio-docker-products](https://github.com/rstudio/rstudio-docker-products). The existing images remain supported.
## Prerequisites
| Tool | Required for | Install |
|------|-------------|---------|
| [Docker](https://docs.docker.com/get-docker/) | Running containers locally | [Get Docker](https://docs.docker.com/get-docker/) |
| [Helm](https://helm.sh/docs/intro/install/) | Deploying on Kubernetes | [Install Helm](https://helm.sh/docs/intro/install/) |
| [kubectl](https://kubernetes.io/docs/tasks/tools/) | Deploying on Kubernetes | [Install kubectl](https://kubernetes.io/docs/tasks/tools/) |
| Product license | Running Posit Workbench | [Licensing FAQ](https://docs.posit.co/licensing/licensing-faq.html) |
## Images
| Image | Docker Hub | GitHub Container Registry |
|:------|:-----------|:--------------------------|
| [workbench](./workbench/) | [`docker.io/posit/workbench`](https://hub.docker.com/r/posit/workbench) | [`ghcr.io/posit-dev/workbench`](https://github.com/posit-dev/images-workbench/pkgs/container/workbench) |
| [workbench-session](./workbench-session/) | [`docker.io/posit/workbench-session`](https://hub.docker.com/r/posit/workbench-session) | [`ghcr.io/posit-dev/workbench-session`](https://github.com/posit-dev/images-workbench/pkgs/container/workbench-session) |
| [workbench-session-init](./workbench-session-init/) | [`docker.io/posit/workbench-session-init`](https://hub.docker.com/r/posit/workbench-session-init) | [`ghcr.io/posit-dev/workbench-session-init`](https://github.com/posit-dev/images-workbench/pkgs/container/workbench-session-init) |
| [workbench-positron-init](./workbench-positron-init/) | [`docker.io/posit/workbench-positron-init`](https://hub.docker.com/r/posit/workbench-positron-init) | [`ghcr.io/posit-dev/workbench-positron-init`](https://github.com/posit-dev/images-workbench/pkgs/container/workbench-positron-init) |
Additional Posit container images are published to [Docker Hub](https://hub.docker.com/u/posit) and [GitHub Container Registry](https://github.com/orgs/posit-dev/packages).
## Running the Images
The fastest way to get started is to pull and run a pre-built image. See each image's documentation for Quick Start examples, configuration, and environment variables.
- [Posit Workbench](./workbench/) — The Workbench server
- [Workbench Session](./workbench-session/) — Session images for Kubernetes
- [Workbench Session Init](./workbench-session-init/) — Init container for Kubernetes session deployments
- [Workbench Positron Init](./workbench-positron-init/) — Init container for Positron IDE in Kubernetes
See the [Workbench installation guide](https://docs.posit.co/ide/server-pro/getting_started/installation/) for full setup instructions.
## Deploying on Kubernetes
Use the [Posit Workbench Helm chart](https://docs.posit.co/helm/charts/rstudio-workbench/README.html) to deploy on Kubernetes.
```bash
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`:
```bash
kubectl create secret generic posit-workbench-license \
--from-file=license.lic=/path/to/license.lic
```
```yaml
image:
repository: ghcr.io/posit-dev/workbench
tag: "2026.01.2"
license:
file:
secret: posit-workbench-license
session:
image:
repository: ghcr.io/posit-dev/workbench-session
tag: "R4.5.2-python3.14.3-ubuntu-24.04"
config:
server:
rserver.conf:
launcher-sessions-init-container-image-name: ghcr.io/posit-dev/workbench-session-init
launcher-sessions-init-container-image-tag: "2026.01.2"
```
The `rserver.conf` entries configure Workbench to use the new session init container image.
Install command:
```bash
helm upgrade --install workbench rstudio/rstudio-workbench --values values.yaml
```
See the [full chart documentation](https://docs.posit.co/helm/charts/rstudio-workbench/README.html) for all available values.
## Building from Source
You can interact with this repository in multiple ways:
* [Build container images directly](#build) from the Containerfile.
* [Use the `bakery` CLI](#using-bakery) to manage and build container images.
* Extend the functionality by using the Minimal base image (see [examples](https://github.com/posit-dev/images-examples)).
## Build
You can build OCI container images from the definitions in this repository using one of the following container build tools:
* [buildah](https://github.com/containers/buildah/blob/main/install.md)
* [docker buildx](https://github.com/docker/buildx#installing)
The root of the bakery project is used as the build context for each Containerfile.
Here, the [`bakery.yaml`](https://github.com/posit-dev/images-shared/blob/main/posit-bakery/CONFIGURATION.md#bakery-configuration) file, or project, is in the root of this repository.
```shell
PWB_VERSION="2026.01"
# Build the standard Workbench image using docker
docker buildx build \
--tag workbench:${PWB_VERSION} \
--file workbench/${PWB_VERSION}/Containerfile.ubuntu2404.std \
.
# Build the minimal Workbench image using buildah
buildah build \
--tag workbench:${PWB_VERSION} \
--file workbench/${PWB_VERSION}/Containerfile.ubuntu2404.min \
.
# Build the minimal Workbench image using podman
podman build \
--tag workbench:${PWB_VERSION} \
--file workbench/${PWB_VERSION}/Containerfile.ubuntu2404.min \
.
```
## Using `bakery`
The structure and contents of this repository were created following the steps in [bakery usage](https://github.com/posit-dev/images-shared/tree/main/posit-bakery#usage).
Additional documentation:
- [Configuration Reference](https://github.com/posit-dev/images-shared/blob/main/posit-bakery/CONFIGURATION.md) — `bakery.yaml` schema and options
- [Templating Reference](https://github.com/posit-dev/images-shared/blob/main/posit-bakery/TEMPLATING.md) — Jinja2 macros for Containerfile templates
- [CI Workflows](https://github.com/posit-dev/images-shared/blob/main/CI.md) — Shared GitHub Actions workflows for building and pushing images
### Prerequisites
Build prerequisites
* [python](https://docs.astral.sh/uv/guides/install-python/)
* [uv](https://docs.astral.sh/uv/getting-started/installation/)
* [docker buildx bake](https://github.com/docker/buildx#installing)
* [just](https://just.systems/man/en/prerequisites.html)
* [gh](https://github.com/cli/cli#installation) (required while repositories are private)
* `bakery`
```shell
just install bakery
```
* `goss` and `dgoss` for running image validation tests
```shell
just install-goss
```
* [`pre-commit`](https://pre-commit.com/) hooks (for contributors)
```shell
just setup
```
### Build with `bakery`
By default, bakery creates an ephemeral JSON [bakefile](https://docs.bakefile.org/en/latest/language.html) to render all containers in parallel.
```shell
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:
```shell
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](https://github.com/posit-dev/images) ecosystem. To extend the Minimal image with additional languages or system dependencies, see the [extending examples](https://github.com/posit-dev/images-examples/tree/main/extending). For shared build tooling and CI workflows, see [images-shared](https://github.com/posit-dev/images-shared).
## Share your Feedback
We invite you to join us on [GitHub Discussions](https://github.com/posit-dev/images/discussions) to ask questions and share feedback.
## Issues
If you encounter any issues or have any questions, please [open an issue](https://github.com/posit-dev/images-workbench/issues). We appreciate your feedback.
## Code of Conduct
We expect all contributors to adhere to the project's [Code of Conduct](CODE_OF_CONDUCT.md) and create a positive and inclusive community.
## License
Posit Container Images and associated tooling are licensed under the [MIT License](LICENSE.md)