{"id":14069757,"url":"https://github.com/rstudio/rstudio-docker-products","last_synced_at":"2025-04-05T02:11:21.383Z","repository":{"id":36652754,"uuid":"190630770","full_name":"rstudio/rstudio-docker-products","owner":"rstudio","description":"Docker images for RStudio Professional Products","archived":false,"fork":false,"pushed_at":"2024-10-29T19:49:41.000Z","size":98515,"stargazers_count":66,"open_issues_count":89,"forks_count":55,"subscribers_count":29,"default_branch":"dev","last_synced_at":"2024-10-29T20:17:52.112Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/u/rstudio","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rstudio.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-06T18:31:12.000Z","updated_at":"2024-10-29T14:19:15.000Z","dependencies_parsed_at":"2023-12-20T10:13:34.203Z","dependency_job_id":"95c100a3-8d5c-4d17-85cc-b20cdc8205b2","html_url":"https://github.com/rstudio/rstudio-docker-products","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Frstudio-docker-products","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Frstudio-docker-products/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Frstudio-docker-products/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rstudio%2Frstudio-docker-products/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rstudio","download_url":"https://codeload.github.com/rstudio/rstudio-docker-products/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247276189,"owners_count":20912288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-13T07:07:11.908Z","updated_at":"2025-04-05T02:11:21.358Z","avatar_url":"https://github.com/rstudio.png","language":"Shell","readme":"# RStudio Pro Products Docker Images\n\nDocker images for RStudio Professional Products\n\n**IMPORTANT:** There are a few things you need to know before using these images:\n\n1. This image may introduce **BREAKING** changes; as such we recommend:\n   - Avoid using the `{operating-system}` tags to avoid unexpected version changes, and\n   - Always read through the NEWS.md file in the appropriate sub-folder to understand the changes before updating.\n1. Outdated images will be removed periodically from DockerHub as product version updates are made. Please make plans to\n   update at times or use your own build of the images.\n1. These images are meant as a starting point for your needs. Consider creating a fork of this repo, where you can\n   continue to merge in changes we make while having your own security scanning, base OS in use, or other custom\n   changes. We\n   provide [instructions for building](https://github.com/rstudio/rstudio-docker-products#instructions-for-building) for\n   these cases.\n1. **Security Note:** These images are provided AS IS based on the build environment at the time their product version was released/updated. They should be reviewed and updated before production use. If your organization has a specific set of security requirements related to CVE/Vulnerability severity levels, you should plan to use the [instructions for building](https://github.com/rstudio/rstudio-docker-products#instructions-for-building) to clone this repository, and rebuild these images to your specific internal security standards.\n\n \n# Images\n\n### Professional Products\n\n- [RStudio Workbench](./workbench/)\n- [RStudio Connect](./connect/)\n- [RStudio Package Manager](./package-manager/)\n\n### Supporting Images\n\n- RStudio Workbench Session Images (requires the launcher)\n    - [R Session Complete](./r-session-complete/)\n- Product Base Images\n    - [Product Base](./product/base)\n    - [Product Base Pro (includes Pro Drivers)](./product/pro)\n- RStudio Connect Session Images (requires the launcher)\n    - [Content Base Image](./content/base/)\n    - [Content Base + Pro Driver Image](./content/pro/)\n    - [Content Init Container](./connect-content-init/)\n\n### Preview Images\n\n*IMPORTANT:* Do not use these images. They are in preparation for a future release\n\n- [RStudio Workbench Preview and Daily](./workbench/)\n- [RStudio Connect Daily](./connect/)\n- [RStudio Package Manager Daily](./package-manager/)\n\n### Image Hierarchy And Relationship\n\n- solid line / arrow: image inheritance\n- dashed line: images related to one another by usage\n\n```mermaid\nflowchart TB;\n  subgraph Product Base Images;\n    id4(\"Product Base\")\n    id5(\"Product Base Pro\")\n    id4--\u003eid5\n  end\n  subgraph s1[\"Connect\"];\n    id1(\"Connect Image\")\n    id2(\"Connect Content Init\")\n    id1-.-id2\n    id5--\u003eid1\n  end;\n  subgraph Package Manager;\n    id3(\"Package Manager Image\")\n    id4--\u003eid3\n  end;\n  subgraph Workbench;\n    id6(\"Workbench Image\")\n    id7(\"r-session-complete\")\n    id5--\u003eid6\n    id5--\u003eid7\n    id6-.-id7\n  end\n  subgraph s5[\"Content Images\"];\n    id8(\"Content Base\")\n    id9(\"Content Pro\")\n    id8--\u003eid9\n  end\n  s1-.-s5\n```\n\n# RStudio Team\n\nWe provide a `docker-compose.yml` that could help to spin up default configurations for RStudio Team (all RStudio\nproducts together).\n\nIf you are using this locally you need to setup some hostnames to point to `localhost` in order for some integrations to\nwork fine in your browser. In your `/etc/hosts` add one line:\n\n```\n127.0.0.1 rstudio-workbench rstudio-connect rstudio-pm\n```\n\n```bash\n# Replace this with valid licenses\nexport RSW_LICENSE=XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX\nexport RSC_LICENSE=XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX\nexport RSPM_LICENSE=XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX\n\ndocker-compose up\n```\n\n# Privileged Containers\n\nAs of July 2022, only the RStudio Connect container uses the `--privileged` flag for user and code isolation and \nsecurity and all other images can be run unprivileged. Please see \n[RStudio Professional Product Root \u0026 Privileged Requirements](https://support.rstudio.com/hc/en-us/articles/1500005369282)\nfor more information.\n\nIf you have feedback on any of our professional products, please always feel free to reach\nout [on RStudio Community](https://community.rstudio.com/c/r-admin), to your Customer Success representative, or to\nsales@rstudio.com.\n\n# Instructions for building\n\nAfter you have cloned [rstudio-docker-products](https://github.com/rstudio/rstudio-docker-products), you can create your\nown containers fairly simply with the provided Justfiles. If you're unfamiliar with `just`, please check out \n[their documentation](https://just.systems/man/en). If you are unable to use `just` in your organization,\nmost targets in each Justfile can be copy/pasted into your shell and ran there with variables replaced where \nappropriate.\n\nWe orchestrate all our builds using `docker buildx bake`. You can learn more about the tool on \n[Docker's buildx bake page](https://docs.docker.com/build/bake/), however no additional background knowledge is needed on the tool in order \nto use it.\n\nTo build all images:\n```bash\njust build\n```\nIndividual images or groups of images can also be built. For example, you can build `connect` by running:\n```bash\njust bake connect\n```\n\nHere are the available targets and groups in bake. To build one, use `just bake \u003ctarget\u003e`:\n- `build` - Builds all images\n- `base-images` - Builds `product/base` and `product/pro`\n- `package-manager` - Builds `package-manager`\n- `connect` - Builds `connect`\n- `workbench` - Builds `workbench`\n- `connect-content-init` - Builds `connect-content-init`\n- `r-session-complete` - Builds `r-session-complete`\n- `workbench-for-google-cloud-workstations` - Builds `workbench-for-google-cloud-workstations`\n- `waml-images` - Builds `workbench-for-microsoft-azure-ml` stack (build, scan, and final)\n\nPreview images and content images are also available to build through the `docker-bake.preview.hcl` and \n`content/docker-bake.hcl` files respectively or use `just preview-bake` and `just content-bake`. \n\nYou can alter what exactly is built by changing `workbench/Dockerfile.$OS`, `connect/Dockerfile.$OS`,\nand `package-manager/Dockerfile.$OS`. Keep in mind that `product/base` or `product/pro` also impact what our default\nimage builds contain.\n\nYou can then run what you've built to test out with the `run` target. For instance, to run the workbench container\nyou have built:\n```\njust RSW_LICENSE=\"\u003clicense key\u003e\" run workbench\n```\n\nYou can also run validation tests on the image using [Goss](https://github.com/goss-org/goss). To run the tests, use \nthe `test` target. For example, to test Connect you can run:\n```\njust test connect\n```\n\nNote you must have a license in place, and all other instructions in separate sections are still relevant.\n\nIf you have created an image you want to use yourself, you can push to your own image repository system. The images are\nnamed `rstudio-workbench`, `rstudio-connect`, and `rstudio-package-manager`.\n\n# Licensing\n\nThe license associated with the RStudio Docker Products repository is\nlocated [in LICENSE.md](https://github.com/rstudio/rstudio-docker-products/blob/main/LICENSE.md).\n\nAs is the case with all container images, the images themselves also contain other software which may be under other\nlicenses (i.e. bash, linux, system libraries, etc., along with any other direct or indirect dependencies of the primary\nsoftware being contained).\n\nIt is an image user's responsibility to ensure that use of this image (and any of its dependent layers) complies with\nall relevant licenses for the software contained in the image.\n","funding_links":[],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Frstudio-docker-products","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frstudio%2Frstudio-docker-products","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frstudio%2Frstudio-docker-products/lists"}