It is possible to test the project locally without installing TLJH. Instead we use the jupyterhub Python package.
jupyterhub
Docker is used as a Spawner to start the user servers, and is then required to run the project locally.
Docker
Spawner
Check out the official Docker documentation to know how to install Docker on your machine: https://docs.docker.com/install/linux/docker-ce/ubuntu/
Using conda:
conda
conda create -n plasma -c conda-forge python nodejs conda activate plasma
Alternatively, with Python’s built in venv module, you can create a virtual environment with:
venv
python3 -m venv . source bin/activate
pip install -r dev-requirements.txt # dev install of the plasma package pip install -e tljh-plasma # Install (https://github.com/jupyterhub/configurable-http-proxy) npm -g install configurable-http-proxy
User environments are built with repo2docker running in a Docker container. To pull the Docker image:
repo2docker
docker pull jupyter/repo2docker
Finally, start jupyterhub with the config in debug mode:
debug
python3 -m jupyterhub -f jupyterhub_config.py --debug
Open https://localhost:8000 in a web browser.