Integrating RStudio Server Pro with Jupyter Notebooks, Launcher, and Kubernetes

Info

Launcher is a new feature of RStudio Server Pro 1.2 that is only available under named user licensing. RStudio Server Pro 1.2 without Launcher is available under existing server-based licensing. For questions about using Launcher with RStudio Server Pro, please contact sales@rstudio.com.

Overview

These steps describe how to integrate RStudio Server Pro with Jupyter Notebooks running with Launcher and Kubernetes.

The most recent rstudio/r-session-complete Docker images referenced in these steps include Python and Jupyter.

Prerequisites

This integration is intended to be performed on top of an installation of RStudio Server Pro that has already been configured with Launcher and Kubernetes.

1. Configure Launcher with Jupyter Notebooks

Add the following lines to the Launcher Jupyter configuration file:

File: /etc/rstudio/jupyter.conf

jupyter-exe=/opt/python/3.6.9/bin/jupyter
notebooks-enabled=1
labs-enabled=1
default-session-cluster=Kubernetes
default-session-container-image=rstudio/r-session-complete:centos7-1.3.959-1

2. Restart RStudio Server Pro and Launcher Services

Terminal

$ sudo rstudio-server restart
$ sudo rstudio-launcher restart

3. Test RStudio Server Pro with Launcher and Jupyter Notebooks

In your browser, navigate to the RStudio Server Pro interface and log in.

Select New Session, choose Jupyter Notebooks or JupyterLab as the IDE, then click the Start Session button.

You can then use the Jupyter Notebooks or JupyterLab interfaces.

(Optional) Configure multiple Python versions or environments

The Python integration steps described above result in a single Python environment that contains both core packages for Jupyter Notebooks as well as Python packages for end users.

While this is a simple approach, this setup can result in issues if end users want to use different versions of the same package or if some packages conflict with core packages for Jupyter Notebooks.

If you would like to use multiple versions of Python or different Python environments, or if you want to install Jupyter Notebook in a separate environment from Python packages for end users, then you can refer to the documentation for using multiple Python versions and environments with Jupyter.

Troubleshooting RStudio Server Pro and Jupyter

Refer to the support article on troubleshooting Jupyter Notebooks in RStudio Server Pro for additional information on troubleshooting RStudio Server Pro with Jupyter.

Additional Documentation

For more information on RStudio Server Pro and Launcher, refer to the following reference documentation: