Skip to content
Ready-to-run Docker images containing Jupyter applications
Python Shell Dockerfile Jupyter Notebook Makefile
Branch: master
Clone or download

Latest commit

Latest commit dc97447 Mar 18, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix one more typo Dec 7, 2019
all-spark-notebook Bump version of R packages Jan 30, 2020
base-notebook Bump miniconda -> 4.8.2 Mar 17, 2020
binder [ci skip] ARG does not survive past FROM Dec 30, 2018
datascience-notebook Merge pull request #1004 from romainx/master Feb 10, 2020
docs [ci skip] Update en source strings (build: 1605.1) Mar 17, 2020
examples fixt typo Oct 18, 2019
minimal-notebook clean tex dependency + test Feb 17, 2020
pyspark-notebook Merge branch 'master' into fix-pyspark Feb 16, 2020
r-notebook Bump r-notebook Feb 23, 2020
scipy-notebook Merge branch 'master' into lab_clean Mar 16, 2020
tensorflow-notebook Fix ssh key format Jan 29, 2020
test Fixed _packages_from_json Mar 12, 2020
.gitattributes Force LF line endings Aug 21, 2018
.gitignore BUG: Generate missing openssl.cnf Feb 3, 2019
.readthedocs.yml Update RTD config file to v2 May 12, 2019
.travis.yml Fix cron test behavior May 5, 2019
CODE_OF_CONDUCT.md [ci skip] Add code of conduct link to jupyter/governance repo May 26, 2018
CONTRIBUTING.md Fix typo, add translation doc link May 19, 2019
LICENSE.md Use updated LICENSE.md file Jan 17, 2016
Makefile Fixed _packages_from_json Mar 12, 2020
README.md Add maintainer help wanted Nov 9, 2019
conftest.py Bump to spark 2.4.5 + minor improvements Feb 11, 2020
pytest.ini Added a note in the documentation Feb 29, 2020
requirements-dev.txt Check outdated packages Feb 12, 2020

README.md

Discourse badge Read the Docs badge DockerHub badge Binder badget

Jupyter Docker Stacks

Jupyter Docker Stacks are a set of ready-to-run Docker images containing Jupyter applications and interactive computing tools.

Maintainer Help Wanted

We value all positive contributions to the Docker stacks project, from bug reports to pull requests to translations to help answering questions. We'd also like to invite members of the community to help with two maintainer activities:

  • Issue triage: Reading and providing a first response to issues, labeling issues appropriately, redirecting cross-project questions to Jupyter Discourse
  • Pull request reviews: Reading proposed documentation and code changes, working with the submitter to improve the contribution, deciding if the contribution should take another form (e.g., a recipe instead of a permanent change to the images)

Anyone in the community can jump in and help with these activities at any time. We will happily grant additional permissions (e.g., ability to merge PRs) to anyone who shows an on-going interest in working on the project.

Quick Start

You can try a recent build of the jupyter/base-notebook image on mybinder.org by simply clicking the preceding link. Otherwise, the two examples below may help you get started if you have Docker installed know which Docker image you want to use, and want to launch a single Jupyter Notebook server in a container.

The User Guide on ReadTheDocs describes additional uses and features in detail.

Example 1: This command pulls the jupyter/scipy-notebook image tagged 17aba6048f44 from Docker Hub if it is not already present on the local host. It then starts a container running a Jupyter Notebook server and exposes the server on host port 8888. The server logs appear in the terminal. Visiting http://<hostname>:8888/?token=<token> in a browser loads the Jupyter Notebook dashboard page, where hostname is the name of the computer running docker and token is the secret token printed in the console. The container remains intact for restart after the notebook server exits.

docker run -p 8888:8888 jupyter/scipy-notebook:17aba6048f44

Example 2: This command performs the same operations as Example 1, but it exposes the server on host port 10000 instead of port 8888. Visiting http://<hostname>:10000/?token=<token> in a browser loads JupyterLab, where hostname is the name of the computer running docker and token is the secret token printed in the console.::

docker run -p 10000:8888 jupyter/scipy-notebook:17aba6048f44

Example 3: This command pulls the jupyter/datascience-notebook image tagged 9b06df75e445 from Docker Hub if it is not already present on the local host. It then starts an ephemeral container running a Jupyter Notebook server and exposes the server on host port 10000. The command mounts the current working directory on the host as /home/jovyan/work in the container. The server logs appear in the terminal. Visiting http://<hostname>:10000/?token=<token> in a browser loads JupyterLab, where hostname is the name of the computer running docker and token is the secret token printed in the console. Docker destroys the container after notebook server exit, but any files written to ~/work in the container remain intact on the host.

docker run --rm -p 10000:8888 -e JUPYTER_ENABLE_LAB=yes -v "$PWD":/home/jovyan/work jupyter/datascience-notebook:9b06df75e445

Contributing

Please see the Contributor Guide on ReadTheDocs for information about how to contribute package updates, recipes, features, tests, and community maintained stacks.

Alternatives

Resources

You can’t perform that action at this time.