Learn how to manually set up and run a Jupyter Lab server on your Genesis Cloud instance. This guide also covers SSH traffic forwarding and the installation of Anaconda and Jupyter.
Introduction
This guide helps you connect a Jupyter server running on your Genesis Cloud instance to your local machine. It is designed for single-user setups. For multi-user configurations, consider using JupyterHub.
Prerequisites
Basic knowledge of starting an instance (refer to this guide if needed).
A running Genesis Cloud instance with JupyterLab.
Starting the JupyterLab Server
To start a browserless JupyterLab server on your remote instance:
jupyter lab --no-browser
The server typically binds to port 8888. You can specify a different port using:
jupyter lab --no-browser --port=XXXX
Note: The server will display URLs with tokens. Save these as you’ll use them shortly.
SSH Traffic Forwarding
- To forward SSH traffic from your local machine:
ssh -L localhost:8888:localhost:8888 ubuntu@<INSTANCE-IP>
- Note: Replace
<INSTANCE-IP>
with the public IP of your instance. If server binds to different port, then use that different port in the SSH port forwarding command.
Accessing the Jupyter Server
- Open the saved URL (with the token) in your local browser. Example URLs:
Installing Anaconda and Jupyter (if not pre-installed), If starting from scratch:
- Download Anaconda:
- Visit the Anaconda distribution page and copy the link to the desired version.
- Download it to your instance: wget <link-to-Anaconda-version>
- Install Anaconda:
- Run the installation script:
chmod +x <path-to-script>
./<path-to-script>
- Run the installation script:
- Install Jupyter:
- After installing Anaconda, you may want to create a new environment:
conda create -n myenv
conda activate myenv
- Install Jupyter Lab:
conda install -c conda-forge jupyterlab
- Run Jupyter Lab:
jupyter lab
- After installing Anaconda, you may want to create a new environment:
You are now ready to use Jupyter on your Genesis Cloud instance!