This guide documents the tasks associated with installing and configuring "The Littlest Jupyterhub" (TLJH) on Nimbus. It is assumed you've already created a VM and are able to log on to it using ssh. The developer's documentation for TLJH is available at https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/custom-server.html.
Network setup:
Jupyterhub will require the standard HTTPS port and we also want to redirect HTTP to HTTPS, so we need to open these ports:
- From your Nimbus dashboard, under the "network" section of the left-hand navigation bar, select "security groups", then click on "create security group" on the right hand side:
- Name: give it a meaningful name (eg jupyterhub)
- Description: open ports to allow jupyterhub to communicate
Once created, click on "manage rules" for that security group, then click on "add rule" in the top right, click Rule and then select HTTP from the drop-down menu.
- Repeat for HTTPS, then it should look like this –
Install TLJH:
- ssh into the VM and check if Python 3, curl, and git are installed (should be installed by default with latest Ubuntu).
Download and run the installer using the following code, making sure to replace <admin username> with the username of the account that will act as adminstrator. If you have yet to create any accounts on the VM simply use "ubuntu".
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py | sudo -E python3 - --admin <admin username>
If everything runs as it should you'll see the following output with the final message being "Done!"
- You can then access the jupyterhub from the public IP associated with your VM, for eg. http://146.118.66.157, and you should see the sign-in page shown below. Note we will resolve the security warning next. If you fail to connect to the jupyterhub check that the security group created in the network setup section has been added to your instance.
Related articles
Filter by label
There are no items with the selected labels at this time.