The dockerspawner (also known as JupyterHub Docker Spawner), enables JupyterHub to spawn single user notebook servers in Docker containers.

There are three basic types of spawners available for dockerspawner:

• DockerSpawner: takes an authenticated user and spawns a notebook server in a Docker container for the user.
• SwarmSpawner: launches single user notebook servers as Docker Swarm mode services.
• SystemUserSpawner: spawns single user notebook servers that correspond to system users.

See the DockerSpawner documentation for more information about features and usage.

Python 3.8 or above and JupyterHub 2.3.1 or above is required.

Install dockerspawner to the system:

pip install dockerspawner

If you would like to contribute to the project (:heart:), please read our contributor documentation and the CONTRIBUTING.md.

We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.

All code is licensed under the terms of the revised BSD license.

We encourage you to ask questions on the Discourse community forum.

• Reporting Issues
• JupyterHub tutorial | Repo | Tutorial documentation
• Documentation for JupyterHub | PDF (latest) | PDF (stable)
• Documentation for JupyterHub's REST API

• Documentation for Project Jupyter | PDF
• Project Jupyter website