Jupyter Notebook Stack
What it Gives You
- Jupyter Notebook server v3.2.x
- Python 3.4.x
- Python 2.7.x
- R 3.2.x
- Julia 0.3.2
- Options for HTTPS, password auth, and passwordless
The following command starts a container with the Notebook server listening for HTTP connections on port 8888 without authentication configured.
docker run -d -p 8888:8888 thephilross/jupyter
You may customize the execution of the Docker container and the Notebook server it contains with the following optional arguments.
-e PASSWORD="YOURPASS"- Configures Jupyter Notebook to require the given password. Should be combined with
USE_HTTPSon untrusted networks.
-e USE_HTTPS=yes- Configures Jupyter Notebook to accept encrypted HTTPS connections. If a
pemfile containing a SSL certificate and key is not found in
/home/phil/.ipython/profile_default/security/notebook.pem, the container will generate a self-signed certificate for you.
-e GRANT_SUDO=yes- Gives the
sudocapability. Useful for installing OS packages. You should only enable
sudoif you trust the user or if the container is running on an isolated host.
-v /some/host/folder/for/work:/home/phil/work- Host mounts the default working directory on the host to preserve work even when the container is destroyed and recreated (e.g., during an upgrade).
-v /some/host/folder/for/server.pem:/home/phil/.ipython/profile_default/security/notebook.pem- Mounts a SSL certificate plus key for
USE_HTTPS. Useful if you have a real certificate for the domain under which you are running the Notebook server.