Package Updates

We actively seek pull requests which update packages already included in the project Dockerfiles. This is a great way for first-time contributors to participate in developing the Jupyter Docker Stacks.

Please follow the process below to update a package version:

  1. Locate the Dockerfile containing the library you wish to update (e.g., base-notebook/Dockerfile, scipy-notebook/Dockerfile)
  2. Adjust the version number for the package. We prefer to pin the major and minor version number of packages so as to minimize rebuild side-effects when users submit pull requests (PRs). For example, you’ll find the Jupyter Notebook package, notebook, installed using conda with notebook=5.4.*.
  3. Please build the image locally before submitting a pull request. Building the image locally shortens the debugging cycle by taking some load off Travis CI, which graciously provides free build services for open source projects like this one. If you use make, call:
make image/somestack-notebook
  1. Submit a pull request (PR) with your changes.
  2. Watch for Travis to report a build success or failure for your PR on GitHub.
  3. Discuss changes with the maintainers and address any build issues. Version conflicts are the most common problem. You may need to upgrade additional packages to fix build failures.