RStudio on GitHub Codespaces

What is Codespaces?

GitHub Codespaces is a hosted development environment in the cloud. Codespaces is Remote Containers customized for GitHub. Once set up, Codespaces can be access through the web-based frontend or local installation of Visual Studio Code.

What is in this repository?

This repository shows how you can run RStudio on GitHub Codespaces starting from Jupyter r-notebook image. The main advantage of this setup is that the resulting container image will also run on Jupyter Hub.

There are three ways to use the container image in this repository.

1. Jupyter Hub
2. GitHub Codespaces
3. docker-compose (requires command line)

Jupyter Hub

Your IT staff will know what to do with the dockerfile

GitHub Codespaces

First, you need access to Codespaces and enabled. Then, the files in .devcontainer directory will do all the work!

Docker Compose

Here are the steps:

# Clone this repository
git clone https://github.com/dddlab/rstudio
cd rstudio

# Symlink .devcontainer contents except devcontainer.json
ln -s .devcontainer/!(devcontainer.json) .

# Build image and start container
docker-compose build rstudio
docker-compose up