Skip to content



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.


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


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.


Dockerspawner and JupyterHub

Project Jupyter