dclong/jupyterhub @DockerHub | @GitHub

JupyterHub in Docker. It is recommended that you use the image dclong/jupyterhub-ds for data science related work. Note: Python packages in this version are installed using pip instead of conda.

Recommended Docker Images

Prerequisite

You need to install Docker before you use this Docker image.

Usage in Linux/Unix

Please refer to the Section Usage of the post My Docker Images for detailed instruction on how to use the Docker image.

The following command starts a container and mounts the current working directory and /home on the host machine to /workdir and /home_host in the container respectively.

docker run -d --init \
    --name jupyterhub \
    --log-opt max-size=50m \
    -p 8000:8000 \
    -e DOCKER_USER=$(id -un) \
    -e DOCKER_USER_ID=$(id -u) \
    -e DOCKER_PASSWORD=$(id -un) \
    -e DOCKER_GROUP_ID=$(id -g) \
    -e DOCKER_ADMIN_USER=$(id -un) \
    -v "$(pwd)":/workdir \
    -v "$(dirname $HOME)":/home_host \
    dclong/jupyterhub /scripts/sys/init.sh

The following command (only works on Linux) does the same as the above one except that it limits the use of CPU and memory.

docker run -d --init \
    --name jupyterhub \
    --log-opt max-size=50m \
    --memory=$(($(head -n 1 /proc/meminfo | awk '{print $2}') * 4 / 5))k \
    --cpus=$(($(nproc) - 1)) \
    -p 8000:8000 \
    -e DOCKER_USER=$(id -un) \
    -e DOCKER_USER_ID=$(id -u) \
    -e DOCKER_PASSWORD=$(id -un) \
    -e DOCKER_GROUP_ID=$(id -g) \
    -e DOCKER_ADMIN_USER=$(id -un) \
    -v "$(pwd)":/workdir \
    -v "$(dirname $HOME)":/home_host \
    dclong/jupyterhub /scripts/sys/init.sh

Use the JupyterHub Server

Add a New User to the JupyterHub Server

Log Information

Detailed Information

Known Issues

About the Author