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.

Development Status

This project is currently in alpha state. Most things work, but we might still make breaking changes that have no clear upgrade pathway. We are targeting a v0.1 release sometime in mid-August 2018. Follow this milestone to see progress towards the release!

Installation

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.

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

Troubleshooting

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

Often, your issues are not related to TLJH itself but to the cloud provider your server is running on. We have some documentation on common issues you might run into with various providers and how to fix them. We welcome contributions here to better support your favorite provider!

Contributing

We want you to contribute to TLJH in the ways that are most useful and exciting to you. This section contains documentation helpful to people contributing in various ways.