R and Jupyter

Simple Jupyter Notebook with R running in docker

Prereqs

• Install Java
• Install Docker Desktop ** Note, if you are installing on Windows, Docker Desktop requires Windows 10 pro. Support for Windows 10 home is coming soon

Getting Started

on Mac

1. Clone the repo
2. cd into jupyter-r
3. run ./gradlew build to build the docker image. this will take a few min
4. run ./gradlew run to start a container from the image and open a web browser to the jupyter application. If the page comes up saying it can't connect, wait a minute to see if it opens.

If you close your browser for any reason, run ./gradlew open to open the app in browser again.

Any changes you make will be saved to your local filesystem.

Run ./gradlew stop to stop the running container.

on Windows

I haven't tested these steps...

1. Clone the repo
2. cd into jupyter-r
3. run gradlew.bat build to build the docker image. this will take a few min
4. run gradlew.bat run to start a container from the image, and open a web browser to the jupyter application. If the page comes up saying it can't connect, wait a minute to see if it opens. If you close your browser for any reason, run gradlew.bat open to open the a pp in browser again.

Any changes you make will be saved to your local filesystem.

Run gradlew.bat stop to stop the running container.

Updating the environment

run the stop gradle task to kill any running containers. run the build gradle task to rebuild the local image with any updates run the run task to start up the environment again

Adding new packages to the environment

Is this really the best tool for R notebooks?

• Perhaps R Notebooks are better than Jupyter Notebooks for R.
• Perhaps you don't need to manage docker locally and instead can use Binder