This is a minimal Alpine-based docker image for running the Jupyter notebook server. It is designed for constrained environments in which the size of the docker image is a major consideration. The latest version (7.x series) is about 340MB uncompressed, much smaller than the official Jupyter images. It is hosted on Docker Hub.
We achieve the small image size by using the Alpine Linux base image, minimizing the number of pre-installed Python packages, and installing other language kernels on the fly. We currently support about a dozen languages, but only Python 2 and 3 are baked into the image. The other kernels are built into Alpine packages (apks) that get installed on first use. We also build popular Python data science packages into pre-compiled apks that can be installed using the ipydeps dependencies mechanism.
For more information, please check out this post on our github.io site.
We are migrating off of this Alpine-based docker image onto Project Jupyter's base image. Please see our new repo at https://github.com/nbgallery/docker-images.
Why move away from Alpine? Three main reasons:
- Our organization's docker orchestration environment originally had image size restrictions, but those have since been relaxed. Meanwhile, the official Jupyter image has gotten smaller, and we'd prefer to build off of the same image as the rest of the community.
- Alpine's Python package support is not great. Packages with native code take a while to install, and some don't build on Alpine at all. Alpine maintains pre-compiled packages such as py3-numpy, but they're not always up-to-date and pip doesn't know about them (which motivated this feature in
ipydeps). - Alpine's package repository is not as complete as other Linux distributions. We've been maintaining some of our own packages, and we'd prefer to get out of that business.
Remember that docker commands usually need to be run as root or via sudo.
You can pull the image from Docker Hub:
docker pull nbgallery/jupyter-alpine
To build the image from source, clone or download the repo. Then build with something like this:
docker build -t nbgallery/jupyter-alpine:<version> <source-directory>
You will usually launch a container something like this:
docker run --rm -p 443:443 nbgallery/jupyter-alpine
The default entrypoint is jupyter-notebook-secure, which will generate a self-signed certificate and then launch the jupyter notebook server under HTTPS with an automatically-generated authentication token.