Skip to content

Commit 1fafb95

Browse files
committed
update docs with 24.04
1 parent df7ff49 commit 1fafb95

File tree

3 files changed

+13
-2
lines changed

3 files changed

+13
-2
lines changed

docs/source/configuration/system.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,11 @@
77
A list of packages in the [`.deb`](<https://en.wikipedia.org/wiki/Deb_(file_format)>) format that should be installed. The `.deb` files are downloaded from the server configured in the Docker base image.
88

99
```{note}
10-
If a `Dockerfile` is not used to change the Docker base image, the base image is [Ubuntu](https://ubuntu.com/) [22.04 LTS (Jammy Jellyfish)](https://releases.ubuntu.com/jammy/). All `.deb` files availables are listed in [Ubuntu Packages](https://packages.ubuntu.com/jammy/).
10+
If a `Dockerfile` is not used to change the Docker base image, the base image is [Ubuntu](https://ubuntu.com/) [24.04 LTS (Noble Numbat)](https://releases.ubuntu.com/noble/). All `.deb` files availables are listed in [Ubuntu Packages](https://packages.ubuntu.com/noble/).
11+
```
12+
13+
```{versionchanged}
14+
Base ubuntu image upgraded from 22.04 to 24.04 in October, 2025
1115
```
1216

1317
We use `apt.txt`, for example, to install LaTeX in our

docs/source/design.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,8 @@ Many ingredients go into making an image from a repository:
4949

5050
`repo2docker` controls the first two, the user controls the third one. The current
5151
policy for the version of the base image is that we will use the current LTS
52-
version Jammy Jellyfish (22.04) for the foreseeable future.
52+
version (24.04) until the start to be build challenges associated with the age of the base system,
53+
at which point it will be increased to the 'current' LTS when that occurs - typically between 2-5 years from the age of release.
5354

5455
The version of `repo2docker` used to build an image can influence which packages
5556
are installed by default and which features are supported during the build

docs/source/howto/breaking_changes.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,12 @@
22

33
Repo2docker occasionally has to make breaking changes in how repositories are built.
44

5+
## Upgrade of base image from Ubuntu 22.04 to 24.04
6+
7+
The base image used by repo2docker was [upgraded from Ubuntu 22.04 to Ubuntu 24.04](https://github.com/jupyterhub/repo2docker/pull/1287) October 2025 (2025.10).
8+
9+
This is unlikely to affect you unless you are using {ref}`apt.txt <apt-txt>`.
10+
511
## Upgrade of base image from Ubuntu 18.04 to 22.04
612

713
The base image used by repo2docker was [upgraded from Ubuntu 18.04 to Ubuntu 22.04](https://github.com/jupyterhub/repo2docker/pull/1287) in version 2023.10.0 due to Ubuntu 18.04 going out of support.

0 commit comments

Comments
 (0)