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.

Herein lies the Dockerfile for jupyter/demo, the container image currently used by tmpnb.org). 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

tmpnb.org 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 tmpnb.org 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 tmpnb.org, 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!

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

# build it
make build
# try it locally
make dev

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

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

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

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

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