Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Docker Demo Image

This repo is archived and no longer used. If you would like to include a demo of your Jupyter kernel, please add a link to your own demo to the try jupyter page by adding a link, description, and logo here.

Original README

Join the chat at

Herein lies the Dockerfile for jupyter/demo, the container image currently used by It inherits from jupyter/minimal-notebook, the base image defined in jupyter/docker-stacks.

Creating sample notebooks does not require knowledge of Docker, just the IPython/Jupyter notebook. Submit PRs against the notebooks/ folder to get started.


The big demo image pulls in resources from:

  • notebooks/ for example notebooks
  • datasets/ for example datasets
  • resources/ for configuration and branding

Community Notebooks is a great resource for communities looking for a place to host their public IPython/Jupyter notebooks. If your group has a notebook you want to share, just fork this repository and add a directory for your community in the notebooks/communities folder and place your notebook in the new directory (e.g. notebooks/communities/north_pole_julia_group/). Commit and push your changes to Github and send us a pull request.

The following tips will make sure your notebooks work well on and work well for the users of your notebook.

  • Create your notebook using Jupyter Notebook 4.x to ensure your notebook is v4 format.
  • If adding a notebook that was a slideshow, make sure to set the "Cell Toolbar" setting back to None.
  • If you are creating your notebook on, make sure you're aware of the 10 minute idle time notebook reaper. If you walk away from your notebook for too long, you can lose it!

Building the Docker Image

There is a Makefile to make life a bit easier here:

# build it
make build
# try it locally
make dev

Updating the Docker Image

The demo image merges jupyter/datascience-notebook and jupyter/all-spark-notebook. It does so by inheriting FROM all-spark-notebook and including the contents of its datascience sibling Dockerfiles. To update the reference tag, edit the TAG variable in the Makefile and run:

make update-tag


Can I use the jupyter/demo Docker image locally?

Sure. Get a docker setup on your host and then do something like the following.

docker pull jupyter/demo
docker run -p 8888:8888 jupyter/demo

Is there a smaller image with fewer languages I can use?

Indeed. See the docker-stacks repository for selection of smaller, more focused Docker images.

When do you update / with new images?

Updates are currently applied ad-hoc, when there's significant demand or new features.

How do I deploy my own temporary notebook site?

Have a look at jupyter/tmpnb for the tech that powers the site and tmpnb-deploy for an Ansible playbook used to deploy the site.


Demo images for use in and




No releases published


You can’t perform that action at this time.