Selecting an Image¶
Using one of the Jupyter Docker Stacks requires two choices:
Which Docker image you wish to use
How you wish to start Docker containers from that image
This section provides details about the first.
Core Stacks¶
The Jupyter team maintains a set of Docker image definitions in the https://github.com/jupyter/docker-stacks GitHub repository. The following sections describe these images including their contents, relationships, and versioning strategy.
jupyter/base-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/base-notebook
is a small image supporting the options common across all core stacks.
It is the basis for all other stacks.
Minimally-functional Jupyter Notebook server (e.g., no LaTeX support for saving notebooks as PDFs)
Miniforge Python 3.x in
/opt/conda
with two package managersnotebook
,jupyterhub
andjupyterlab
packagesNo preinstalled scientific computing packages
Unprivileged user
jovyan
(uid=1000
, configurable, see options) in groupusers
(gid=100
) with ownership over the/home/jovyan
and/opt/conda
pathstini
as the container entrypoint and astart-notebook.sh
script as the default commandA
start-singleuser.sh
script useful for launching containers in JupyterHubA
start.sh
script useful for running alternative commands in the container (e.g.ipython
,jupyter kernelgateway
,jupyter lab
)Options for a self-signed HTTPS certificate and passwordless sudo
jupyter/minimal-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/minimal-notebook
adds command line tools useful when working in Jupyter applications.
jupyter/r-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/r-notebook
includes popular packages from the R ecosystem.
Everything in
jupyter/minimal-notebook
and its ancestor imagesThe R interpreter and base environment
IRKernel to support R code in Jupyter notebooks
tidyverse packages from conda-forge
caret, crayon, devtools, forecast, hexbin, htmltools, htmlwidgets, nycflights13, randomforest, rcurl, rmarkdown, rodbc, rsqlite, shiny, tidymodels, unixodbc packages from conda-forge
jupyter/scipy-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/scipy-notebook
includes popular packages from the scientific Python ecosystem.
Everything in
jupyter/minimal-notebook
and its ancestor imagesaltair, beautifulsoup4, bokeh, bottleneck, cloudpickle, conda-forge::blas=*=openblas, cython, dask, dill, h5py, matplotlib-base, numba, numexpr, pandas, patsy, protobuf, pytables, scikit-image, scikit-learn, scipy, seaborn, sqlalchemy, statsmodel, sympy, widgetsnbextension, xlrd packages
ipympl and ipywidgets for interactive visualizations and plots in Python notebooks
Facets for visualizing machine learning datasets
jupyter/tensorflow-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/tensorflow-notebook
includes popular Python deep learning libraries.
Everything in
jupyter/scipy-notebook
and its ancestor imagestensorflow machine learning library
jupyter/datascience-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/datascience-notebook
includes libraries for data analysis from the Julia, Python, and R
communities.
jupyter/pyspark-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/pyspark-notebook
includes Python support for Apache Spark.
Everything in
jupyter/scipy-notebook
and its ancestor imagesApache Spark with Hadoop binaries
pyarrow library
jupyter/all-spark-notebook¶
Source on GitHub | Dockerfile commit history | Docker Hub image tags
jupyter/all-spark-notebook
includes Python, R, and Scala support for Apache Spark.
Everything in
jupyter/pyspark-notebook
and its ancestor imagesIRKernel to support R code in Jupyter notebooks
spylon-kernel to support Scala code in Jupyter notebooks
Image Relationships¶
The following diagram depicts the build dependency tree of the core images. (i.e., the FROM
statements in their Dockerfiles).
Any given image inherits the complete content of all ancestor images pointing to it.
Builds¶
Every Monday and whenever a pull requests is merged, images are rebuilt and pushed to the public container registry.
Community Stacks¶
The core stacks are just a tiny sample of what's possible when combining Jupyter with other technologies. We encourage members of the Jupyter community to create their own stacks based on the core images and link them below.
csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter Notebooks. The image includes more than 200 Jupyter Notebooks with example C# code and can readily be tried online via mybinder.org. Try it on .
education-notebook is a community Jupyter Docker Stack image. The image includes nbgrader and RISE on top of the datascience-notebook image. Try it on .
jamesdbrock/ihaskell-notebook
Source on GitHub | Dockerfile commit history | Github container registry
jamesdbrock/ihaskell-notebook
is based on IHaskell. Includes popular packages and example notebooks.java-notebook is a community Jupyter Docker Stack image. The image includes IJava kernel on top of the minimal-notebook image. Try it on .
sage-notebook is a community Jupyter Docker Stack image with the sagemath kernel on top of the minimal-notebook image. Try it on .
GPU-Jupyter: Leverage Jupyter Notebooks with the power of your NVIDIA GPU and perform GPU calculations using Tensorflow and Pytorch in collaborative notebooks. This is done by generating a Dockerfile, that consists of the nvidia/cuda base image, the well-maintained docker-stacks that is integrated as submodule and GPU-able libraries like Tensorflow, Keras and PyTorch on top of it.
PRP GPU Jupyter repo and Registry PRP (Pacific Research Platform) maintained registry for jupyter stack based on NVIDIA CUDA-enabled image. Added the PRP image with Pytorch and some other python packages, and GUI Desktop notebook based on https://github.com/jupyterhub/jupyter-remote-desktop-proxy.
cgspatial-notebook is a community Jupyter Docker Stack image. The image includes major geospatial Python & R libraries on top of the datascience-notebook image. Try it on
kotlin-notebook is a community Jupyter Docker Stack image. The image includes Kotlin kernel for Jupyter/IPython on top of the
base-notebook
image. Try it on
See the contributing guide for information about how to create your own Jupyter Docker Stack.