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 


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>


  • 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


You are now ready to use Jupyter on your Genesis Cloud instance!