CHANGELOG.md

Change Log

This change log covers changes to the docker image and does not include changes to the micromamba program.

21 March 2026

• Resume copying _apptainer_shell.sh into images
• Update CUDA v13.1.0 images to CUDA v13.2.0

12 January 2026

• Updated to micromamba version 2.5.0
• No longer clobber $HOME values passed via docker run -e HOME ... (for $HOME values other than /).

20 December 2025

• Update CUDA v13.0.2 images to v13.1.0

7 December 2025

• Removed end of life base image alpine:3.19
• Update CUDA v13.0.1 images to CUDA v13.0.2
• Start building alpine images for linux/arm64 platform

21 November 2025

• Updated to micromamba version 2.4.0

27 October 2025

• Updated to micromamba version 2.3.3
• Remove end of life base image ubuntu:20.04

11 Oct 2025

• Add image based on ubuntu-25.10
• Add image based on alpine:3.22
• Update CUDA v13.0.0 images to CUDA v13.0.1.
• Removed end of life base image ubuntu:25.04
• Removed end of life base image alpine:3.18

27 Aug 2025

• Updated to micromamba version 2.3.2
• Add image based on debian:13
• Add image based on debian:13-slim
• Add image based on nvidia/cuda:13.0.0-base-ubuntu24.04
• Add image based on nvidia/cuda:13.0.0-base-ubuntu22.04
• Removed end of life base image debian:11
• Removed end of life base image debian:11-slim
• Removed end of life base image ubuntu:24.10
• Update CUDA v12.9.0 images to CUDA v12.9.1.

28 July 2025

• Updated to micromamba version 2.3.1

16 June 2025

• Updated to micromamba version 2.3.0

5 June 2025

• Updated to micromamba version 2.2.0

28 May 2025

• Add image based on nvidia/cuda:12.9.0-base-ubuntu24.04
• Add image based on nvidia/cuda:12.9.0-base-ubuntu22.04
• Add image based on nvidia/cuda:12.9.0-base-ubuntu20.04

14 May 2025

• Set CONDA_OVERRIDE_CUDA in cuda images

5 May 2025

• Updated to micromamba version 2.1.1

27 April 2025

• Add image based on ubuntu:25.04
• Add image based on alpine:3.21
• Remove alpine v3.20.x from build pipelines due to an upstream issue. Our existing alpine3.20 tags will continue to exist, but they will not receive new builds. Therefore, the highest version of micromamba that will be accessible via alpine3.20 tags is v2.0.8.

10 April 2025

• Updated to micromamba version 2.1.0

20 March 2025

• Updated to micromamba version 2.0.8

16 March 2025

• set cuda tag image based on nvidia/cuda:12.8.1-base-ubuntu24.04

15 March 2025

• Updated to micromamba version 2.0.7
• Add image based on nvidia/cuda:12.8.1-base-ubuntu24.04
• Add image based on nvidia/cuda:12.8.1-base-ubuntu22.04
• Add image based on nvidia/cuda:12.8.1-base-ubuntu20.04

10 February 2025

• Reverted to micromamba 2.0.5

5 February 2025

• Updated to micromamba version 2.0.6
• no longer attempt to source mamba.sh in _activate_current_env.sh

21 December 2024

• Removed end of life base image alpine:3.17
• Update CUDA v12.6.2 images to CUDA v12.6.3

16 December 2024

• Updated to micromamba version 2.0.5

25 November 2024

• Updated to micromamba version 2.0.4

6 November 2024

• Updated to micromamba version 2.0.3

28 October 2024

• Update CUDA v12.6.1 images to CUDA v12.6.2

10 October 2024

• Update CUDA v12.6.0 images to CUDA v12.6.1
• Add image based on ubuntu:24.10

9 October 2024

• Fixed/added the following tags: alpine, debian, debian-slim, ubuntu, amazon, cuda

8 October 2024

• Updated to micromamba version 2.0.2
• Breaking Change: Our image tagging scheme has been changed. We are no longer making use of release names (such as bullseye or bookworm for debian or noble or jammy for ubuntu) in the tags. Instead we are using version numbers such as 12 for debian or 22.04 for ubuntu. As always, you can find the full list of current tags on Dockerhub.
• Add image based on public.ecr.aws/amazonlinux/amazonlinux:2023
• To support adding the amazonlinux base image (which is derived from RHEL), we have moved from a single Dockerfile, to multiple Dockerfile files.

20 September 2024

• Updated to micromamba version 1.5.10

3 September 2024

• Add image based on nvidia/cuda:12.6.0-base-ubuntu24.04
• Add image based on nvidia/cuda:12.6.0-base-ubuntu22.04
• Add image based on nvidia/cuda:12.6.0-base-ubuntu20.04
• Update CUDA v12.5.0 images to CUDA v12.5.1
• Removed end of life base image ubuntu:lunar
• Removed end of life base image ubuntu:mantic
• Removed end of life base image nvidia/cuda:11.3.1-base-ubuntu20.04
• Removed end of life base image nvidia/cuda:11.2.2-base-ubuntu20.04

31 August 2024

• Updated to micromamba version 1.5.9

5 July 2024

• Add image based on alpine:3.20
• Add image based on nvidia/cuda:12.5.0-base-ubuntu22.04
• Add image based on nvidia/cuda:12.5.0-base-ubuntu20.04
• Update CUDA v12.3.1 images to CUDA v12.3.2

26 April 2024

• Add image based on ubuntu:noble
• Add image based on nvidia/cuda:12.4.1-base-ubuntu22.04
• Add image based on nvidia/cuda:12.4.1-base-ubuntu20.04

26 March 2024

• Updated to micromamba version 1.5.8

4 March 2024

• Updated to micromamba version 1.5.7

30 December 2023

• Add image based on alpine:3.19

27 December 2023

• Added back alpine:3.17 base image with alpine3.17 as the tag
• Added tag alpine3.18 for alpine:3.18 base image
• Tag alpine will now be a rolling tag that is assigned to the most recent alpine image

23 December 2023

• Use packaging.version instead of semver to parse version numbers in check_version.py

22 December 2023

• Updated to micromamba version 1.5.6

21 December 2023

• Improved error handling in check_version.py

14 December 2023

• Updated to micromamba version 1.5.5

13 December 2023

• Add image based on nvidia/cuda:11.2.2-base-ubuntu20.04
• Update CUDA v12.2.0 images to CUDA v12.2.2
• Update CUDA v12.3.0 images to CUDA v12.3.1

4 December 2023

• Add image based on nvidia/cuda:11.4.3-base-ubuntu20.04

2 December 2023

• Add base images for cuda version 12.2.0
• Remove alpine:3.17 base image as it no longer receives a unique tag

14 November 2023

• Updated to micromamba version 1.5.3

5 November 2023

• Added /usr/local/bin/_apptainer_shell.sh for use with apptainer shell -shell /usr/local/bin/_apptainer_shell.sh ...
• Add tests of apptainer run, apptainer exec, and apptainer shell

19 October 2023

• Add image based on alpine:3.18
• Add image based on ubuntu:mantic
• Removed package version pinning for shadow from modify username example as it was causing issues with testing

12 September 2023

• Restore documentation that was accidently lost in transition to readthedocs.io

5 September 2023

• Updated to micromamba version 1.5.1
• Added FAQ on use with apptainer/singularity

24 August 2023

• Updated to micromamba version 1.5.0
• Move all images to have mambauser use UID/GID 57439
• latest tag now references an image based on debian:bookworm-slim
• Add script test_with_all_images.sh
• fix test for example of generating a conda lock file

23 August 2023

• Remove end of life base image ubuntu:kinetic

17 July 2023

• Add base image ubuntu:lunar

  uid and gid 1000 is not available in ubuntu:lunar, mambauser uid and gid is set to 57439

• tests updated to allow for ubuntu:lunar's uid and gid values

15 July 2023

• Add base images for cuda version 12.2.0
• Remove base images containing Ubuntu 18.04 (bionic) as they are end of life

13 July 2023

• Updated to micromamba version 1.4.9

11 July 2023

• Updated to micromamba version 1.4.8

8 July 2023

• Documentation converted to rst format, hosted on readthedocs.io

6 July 2023

• Update to micromamba version 1.4.7

1 July 2023

• Update to micromamba version 1.4.6

29 Jun 2023

• Update to micromamba version 1.4.5

20 June 2023

• Add Debian Bookworm base images

15 June 2023

• Update to micromamba version 1.4.4

23 May 2023

• bump requests python package from 2.26.0 to 2.31.0

16 May 2023

• Update to micromamba version 1.4.3

15 May 2023

• Revert broken add of ubuntu:lunar base image

13 May 2023

• Add ubuntu:lunar base image

10 May 2023

• Add base images for cuda 12.1.1

7 April 2023

• Update to micromamba version 1.4.2

28 March 2023

• Update to micromamba version 1.4.1

23 March 2023

• Update to micromamba version 1.4.0

14 March 2023

• Also push images to GitHub Container Registry

10 March 2023

• Add base images for cuda 12.1.0

21 Febuary 2023

• In .gitattributes fix line endings for *.sh files to allow building on Windows

19 Febuary 2023

• Start FAQ

9 Febuary 2023

• update add_micromamba example to include USER root before copying files in

3 Febuary 2023

• added support for alpine base image
• bump CUDA 12 to 12.0.1

17 January 2023

• added base image ubuntu:kinetic
• added base image nvidia/cuda:12.0.0-base-ubuntu22.04
• added base image nvidia/cuda:12.0.0-base-ubuntu20.04

8 September 2022

• Automatically perform shell initialization for conda and mamba if they are installed
• Drop the base image debian:buster and debian:buster-slim as they are no longer under offical debian support
• Install shell hooks for micromamba, conda, and mamba even if MAMBA_SKIP_ACTIVATE=1

7 July 2022

• Moved code from Dockerfile to separate bash scripts _dockerfile_initialize_user_accounts.sh and _dockerfile_setup_root_prefix.sh

6 July 2022

• Add images based on nvidia/cuda:*-base-ubuntu*

5 June 2022

• Build images from all Debian releases that have not yet reached end of life
• Build images from both slim and non-slim Debian images
• Revamp tagging to support multiple base images

13 January 2022

• Change the default username from micromamba to mambauser.
• Add the environment variable MAMBA_USER to store the value of the default username.

15 December 2021

• If environmental variable MAMBA_SKIP_ACTIVATE is set to 1, then no conda environment will be automatically activated during a docker run ... command.

14 December 2021

• Images are now built on every push to main branch or when cronjob sees that conda-forge has a newer version of micromamba that does not yet have a corresponding image on dockerhub
• Images will now also be tagged with a the short version of the git SHA hash from this git repository.
• The outputs of check_version.py have been modified to make the build scripts better

13 December 2021

• Consolidated activation code into /usr/local/bin/_activate_current_env.sh
• Moved _entrypoint.sh and _docker_shell.sh into /usr/local/bin

8 December 2021

• Stop adding MAMBA_ROOT_PREFIX/bin in PATH.
• Remove tests that override entrypoint. Users should not expect their conda env to get activated if they interfere with the entrypoint script.
• Remove test of using RUN command with 'exec' form to access conda installed software. This required the PATH modification that is being removed. Use 'shell' form of RUN command instead.
• Remove call to micromamba that adds shell completion commands from .bashrc, as this is now included in the shell hooks command.

4 December 2021

• Activation of conda env during docker build is now triggered by ARG MAMBA_DOCKERFILE_ACTIVATE=1
• Entrypoint script moved to /bin/_entrypoint.sh
• SHELLnow set to /bin/_dockerfile_shell.sh, which activates an environment within the docker build if MAMBA_DOCKERFILE_ACTIVATE=1 and then executes any arguments using /bin/bash

30 November 2021

• Move setup of bash environment from entrypoint to .bashrc
• Modifications to .bashrc are done during image build

5 November 2021

• Entrypoint evaluates the micromamba shell hook directly
• Entrypoint no longer writes to ~/.bashrc

18 September 2021

• base image changed from debian:buster-slim to debian:bullseye-slim
• added tests to check that example Dockerfiles build

6 September 2021

• add build for pcc64le

30 June 2021

• default user changed from root to micromamba