Skip to content

jupyterhub/dockerspawner

DockerSpawner

Latest PyPI version Latest conda-forge version GitHub Workflow Status - Test Test coverage of code Issue tracking - GitHub Help forum - Discourse

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.

Prerequisites

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

Installation

Install dockerspawner to the system:

pip install dockerspawner

Contributing

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

License

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.

Getting help

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

Resources

Dockerspawner and JupyterHub

Project Jupyter