Coder RStudio Workspace Template

This repository provides a Terraform-based template for deploying an RStudio Server workspace inside Docker using Coder.

Features

• RStudio Server in Docker
• Coder workspace integration
• Persistent home directory
• Optional renv support
• UI-configurable parameters

Usage

Import into Coder

1. Open Coder UI
2. Go to Templates
3. Click Create Template
4. Select From Git Repository
5. Enter this repository URL
6. Create the template

Create Workspace

• Select the template
• Configure parameters
• Launch workspace
• Open RStudio from the UI

Parameters

• rstudio_password – Password for RStudio
• enable_renv – Enable renv restore
• docker_socket – Optional Docker socket

Notes

• RStudio runs internally on port 8787
• Access is handled via Coder proxy
• No direct port exposure required

Repository Structure

coder-rstudio
├── coder_parameters.tf
├── main.tf
├── modules
│   └── rstudio
│       ├── main.tf
│       ├── run.sh
│       └── variables.tf
├── README.md
└── variables.tf

Brief Explanation

• coder_parameters.tf → UI inputs for the Coder template
• main.tf → Entry point/orchestration (Coder agent + modules)
• modules/rstudio/ → isolated RStudio setup
  • main.tf → resources (script and app)
  • variables.tf → module variables
  • run.sh → startup script for the RStudio container
  • .gitignore → prevents Terraform state from being committed to the repo
• README.md → documentation
• variables.tf → Terraform variables (backend/defaults)