Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jupyterhub/the-littlest-jupyterhub

Simple JupyterHub distribution for 1-100 users on a single server
https://github.com/jupyterhub/the-littlest-jupyterhub

education jupyterhub

Last synced: 19 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/jupyterhub/the-littlest-jupyterhub
Owner: jupyterhub
License: bsd-3-clause
Created: 2018-06-15T22:37:12.000Z (over 6 years ago)
Default Branch: main
Last Pushed: 2024-09-30T13:27:38.000Z (about 1 month ago)
Last Synced: 2024-10-02T02:04:25.740Z (about 1 month ago)
Topics: education, jupyterhub
Language: Python
Homepage: https://tljh.jupyter.org
Size: 9.56 MB
Stars: 1,032
Watchers: 34
Forks: 340
Open Issues: 138
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/contributing/code-review.md
- License: LICENSE

Awesome Lists containing this project

README

        # The Littlest JupyterHub

[![Documentation build status](https://img.shields.io/readthedocs/the-littlest-jupyterhub?logo=read-the-docs)](https://tljh.jupyter.org/en/latest/?badge=latest)

[![GitHub Workflow Status - Test](https://img.shields.io/github/actions/workflow/status/jupyterhub/the-littlest-jupyterhub/integration-test.yaml?logo=github&label=tests)](https://github.com/jupyterhub/the-littlest-jupyterhub/actions)

[![Test coverage of code](https://codecov.io/gh/jupyterhub/the-littlest-jupyterhub/branch/main/graph/badge.svg)](https://codecov.io/gh/jupyterhub/the-littlest-jupyterhub)

[![GitHub](https://img.shields.io/badge/issue_tracking-github-blue?logo=github)](https://github.com/jupyterhub/the-littlest-jupyterhub/issues)

[![Discourse](https://img.shields.io/badge/help_forum-discourse-blue?logo=discourse)](https://discourse.jupyter.org/c/jupyterhub/tljh)

[![Gitter](https://img.shields.io/badge/social_chat-gitter-blue?logo=gitter)](https://gitter.im/jupyterhub/jupyterhub)

[![Contribute](https://img.shields.io/badge/I_want_to_contribute!-grey?logo=jupyter)](https://tljh.jupyter.org/en/latest/contributing/index.html)

**The Littlest JupyterHub** (TLJH) distribution helps you provide Jupyter Notebooks

to 1-100 users on a single server.

The primary audience are people who do not consider themselves 'system administrators'

but would like to provide hosted Jupyter Notebooks for their students or users.

All users are provided with the same environment, and administrators

can easily install libraries into this environment without any specialized knowledge.

See the [latest documentation](https://the-littlest-jupyterhub.readthedocs.io)

for more information on using The Littlest JupyterHub.

For support questions please search or post to [our forum](https://discourse.jupyter.org/c/jupyterhub/).

See the [contributing guide](https://the-littlest-jupyterhub.readthedocs.io/en/latest/contributing/index.html)

for information on the different ways of contributing to The Littlest JupyterHub.

See [this blog post](http://words.yuvi.in/post/the-littlest-jupyterhub/) for

more information.

## Development Status

This project is currently in **beta** state. Folks have been using installations

of TLJH for more than a year now to great success. While we try hard not to, we

might still make breaking changes that have no clear upgrade pathway.

## Installation

The Littlest JupyterHub (TLJH) can run on any server that is running at least

**Ubuntu 20.04**. Earlier versions of Ubuntu are not supported.

We have several tutorials to get you started.

- Tutorials to create a new server from scratch on a cloud provider & run TLJH

  on it. These are **recommended** if you do not have much experience setting up

  servers.

  - [Digital Ocean](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/digitalocean.html)

  - [OVH](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/ovh.html)

  - [Google Cloud](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/google.html)

  - [Jetstream](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/jetstream.html)

  - [Amazon Web Services](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/amazon.html)

  - [Microsoft Azure](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/azure.html)

  - ... your favorite provider here, if you can contribute!

- [Tutorial to install TLJH on an already running server you have root access to](https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/custom-server.html).

  You should use this if your cloud provider does not already have a direct tutorial,

  or if you have experience setting up servers.

## 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](https://github.com/jupyterhub/the-littlest-jupyterhub/issues) about it - or

even better, [contribute a documentation fix](http://the-littlest-jupyterhub.readthedocs.io/en/latest/contributing/docs.html)!