The Littlest JupyterHub on Azure

[Lee Stott]

The Littlest JupyterHub

A simple JupyterHub distribution for a small (0-100) number of users on a single server. We recommend reading When to use The Littlest JupyterHub to determine if this is the right tool for you.

Installation on Azure

The Littlest JupyterHub (TLJH) can run on any server that is running at least Ubuntu 18.04. Earlier versions of Ubuntu are not supported. We have a bunch of tutorials to get you started.

• Using the tutorial is recommended if you do not have much experience setting up servers.

  • Installing on Azure
  • Installing on your own server

Once you are ready to run your server for real, it’s a good idea to proceed directly to Enable HTTPS.

Content and Data

• Distributing materials to users with nbgitpuller
• Adding data to the JupyterHub
• Share data with your users

The user environment

• Install conda, pip or apt packages
• Change default User Interface for users
• Configure resources available to users

Authentication

We have a special set of How-To Guides on using various forms of authentication with your JupyterHub. For more information on Authentication, see Configuring JupyterHub authenticators

• Authenticate any user with a single shared password
• Authenticate using GitHub Usernames
• Let users choose a password when they first log in
• Let users sign up with a username and password

Administration and security

• Add / Remove admin users
• Estimate Memory / CPU / Disk needed
• Resize the resources available to your JupyterHub
• Check your memory usage
• Enable HTTPS
• Enabling Jupyter Notebook extensions

Cloud provider configuration

• Perform common Microsoft Azure configuration tasks

Topic Guides

Topic guides provide in-depth explanations of specific topics.

• When to use The Littlest JupyterHub
• Server Requirements
• Security Considerations
• Customizing the Installer
• What does the installer do?
• Configuring TLJH with tljh-config
• Configuring JupyterHub authenticators
• Custom jupyterhub_config.py snippets

Troubleshooting

In time, all systems have issues that need to be debugged. Troubleshooting guides help you find what is broken & hopefully fix it.

• Looking at Logs

• Troubleshooting issues on your own server