jupyter / Docker Demo Images
Labels
Projects that are alternatives of or similar to Docker Demo Images
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
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.
Organization
The big demo image pulls in resources from:
-
notebooks/
for example notebooks -
datasets/
for example datasets -
resources/
for configuration and branding
Community Notebooks
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!
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
FAQ
jupyter/demo
Docker image locally?
Can I use the 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 try.jupyter.org / tmpnb.org 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 tmpnb.org site and tmpnb-deploy for an Ansible playbook used to deploy the site.