Supported tags

• latest — the stable master branch
• x.x — all stable releases of Sage are tagged with their version number.
• x.x.{beta,rc}x - betas and release candidates of Sage as tagged in our git repository; since docker images are built and uploaded manually at the moment, there are often no recent betas here anymore.
• develop — the current development version of Sage which gets merged into the master branch when a new version of Sage is released ; again, there is often no recent develop build here anymore.
• -py3 - until Sage 9.1, we provided Python 2 builds (with no suffix) and Python 3 builds (with the -py3 suffix). From Sage 9.2.beta0 on, all images we provide are based on Python 3 and the -py3 suffix survives only for historical reasons: with or without it, you get Python 3.

What is SageMath

SageMath is a free open-source mathematics software system licensed under the GPL. It builds on top of many existing open-source packages: NumPy, SciPy, matplotlib, Sympy, Maxima, GAP, FLINT, R and many more. Access their combined power through a common, Python-based language or directly via interfaces or wrappers.

Mission: Creating a viable free open source alternative to Magma, Maple, Mathematica and Matlab.

What's in this image

There are several flavours of this image.

• sagemath/sagemath contains everything necessary to run Sage on the command line. Run it with:

  docker run -it sagemath/sagemath:latest
  

  You can start a graphical Jupyter Notebook at http://localhost:8888 instead. To use the notebook, follow the instructions printed when you run:

  docker run -p 8888:8888 sagemath/sagemath:latest sage-jupyter
  

• sagemath/sagemath-dev contains all the build artifacts to rebuild Sage quickly (currently, this is broken, see #34241.) This version is probably only relevant for Sage developers. Run this image with:

  docker run -it sagemath/sagemath-dev:develop
  

  This triggers a rebuild and drops you in a shell afterwards. Note that the git repository has been emptied to save space. If you want to use git, fetch from your git repository with git fetch trac and go to the commit that was used to create this image with

  git reset $(cat docker/.commit)
  

How to build your own SageMath images

Run docker build -f docker/Dockerfile --build-arg ARTIFACT_BASE=sagemath/sagemath-dev:develop --target TARGET . in the Sage repository with TARGET one of sagemath or sagemath-dev.

How these images get updated

Currently, these images are updated manually after every release. Instructions for this are at the top of docker/Dockerfile.

Every push to our GitLab repository used to trigger a pipeline in GitLab CI which pushed the actual images to Docker Hub. These pipelines are not running anymore since nobody is maintaining them or providing the CI resources for it. (Please reach out to sage-devel if you want to help!)

Have a look at .gitlab-ci.yml if you want to setup GitLab CI for your own fork of the SageMath repository.

Report bugs and issues

Please tell us of any bugs or omissions at our Issue Tracker or contact us through the sage-support or the sage-devel mailing lists.

License

The whole Sage software distribution is licensed under the General Public License, version 3. More details can be found in our COPYING.txt