Jupyter Notebook Data Science Stack
What it Gives You
- Jupyter Notebook 4.0.x
- Conda Python 3.x and Python 2.7.x environments
- pandas, matplotlib, scipy, seaborn, scikit-learn, scikit-image, sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh pre-installed
- Conda R v3.2.x and channel
- plyr, devtools, dplyr, ggplot2, tidyr, shiny, rmarkdown, forecast, stringr, rsqlite, reshape2, nycflights13, caret, rcurl, and randomforest pre-installed
- Julia v0.3.x with Gadfly and RDatasets pre-installed
- Unprivileged user
jovyan(uid=1000, configurable, see options) in group
users(gid=100) with ownership over
- tini as the container entrypoint and start-notebook.sh as the default command
- 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 jupyter/datascience-notebook
docker run -d -p 8888:8888 jupyter/datascience-notebook start-notebook.sh --NotebookApp.base_url=/some/path
You can sidestep the
start-notebook.sh script entirely by specifying a command other than
start-notebook.sh. If you do, the
GRANT_SUDO features documented below will not work. See the Docker Options section for details.
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 conbined 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/jovyan/.ipython/profile_default/security/notebook.pem, the container will generate a self-signed certificate for you.
-e NB_UID=1000- Specify the uid of the
jovyanuser. Useful to mount host volumes with specific file ownership. For this option to take effect, you must run the container with
--user root. (The
su jovyanafter adjusting the user id.)
-e GRANT_SUDO=yes- Gives the
sudocapability. Useful for installing OS packages. For this option to take effect, you must run the container with
--user root. (The
su jovyanafter adding
jovyanto sudoers.) 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/jovyan/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/jovyan/.local/share/jupyter/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.
The default Python 3.x Conda environment resides in
/opt/conda. A second Python 2.x Conda environment exists in
/opt/conda/envs/python2. You can switch to the python2 environment in a shell by entering the following:
source activate python2
You can return to the default environment with this command:
conda (among others) are available in both environments.