/the-littlest-jupyterhub

Simple JupyterHub distribution for 1-100 users on a single server

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

The Littlest JupyterHub

https://circleci.com/gh/jupyterhub/the-littlest-jupyterhub.svg?style=shield https://readthedocs.org/projects/the-littlest-jupyterhub/badge/?version=latest

The Littlest JupyterHub (TLJH) distribution helps you provide Jupyter Notebooks to 1-50 users on a single server.

Administrators who do not consider themselves 'system administrators' but would like to provide hosted Jupyter Notebooks for their students / users are the primary audience. All users get the same environment, and administrators can install libraries into this environment without any specialized knowledge. It provides all users with the same environment, and administrators can install libraries into this environment easily without any specialized knowledge.

See this blog post for more information.

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. We have a bunch of tutorials to get you started!

Documentation

Our latest documentation is at: https://the-littlest-jupyterhub.readthedocs.io

We place a high importance on consistency, readability and completeness of documentation. If a feature is not documented, it does not exist. If a behavior is not documented, it is a bug! We try to treat our documentation like we treat our code: we aim to improve it as often as possible.

If something is confusing to you in the documentation, it is a bug. We would be happy if you could file an issue about it - or even better, contribute a documentation fix!