docker-nbi-jupyterhub
A jupyterhub docker image that by default supports the following extensions.
Get Started
If you are simply interested in running the jupyterhub, simply run the following command inside the repo directory:
cd hub docker build -t ucphhpc/jupyterhub . # To run a single notebook in detached mode do the following docker run -d --name jupyterhub -p 8000:8000 ucphhpc/jupyterhub:edge
A container should now be running locally, double check with:
docker ps
If the container is present, you should now be able to connect to it in your browser @ 127.0.0.1:8000, double check by getting the log output from the jupyterhub service:
docker logs jupyterhub
To setup an authentication method either use the provided Remote-User authenticator or use the testing dummy authenticator. See https://github.com/jupyterhub/jupyterhub/wiki/Authenticators for more information on this.
Testing Build
To also build and verify the image works in one go the following can be done instead:
cd hub ./build.sh
Two images should now have been built, i.e. 'ucphhpc/jupyterhub:edge' and 'ucphhpc/jupyterhub:edge-test'
The test image is an extended version of the ucphhpc/jupyterhub:edge image but a test script that verifies that the jupyterhub server is able to launch correctly. This test can be run by simply running:
docker run ucphhpc/jupyterhub:edge-test