Release Notes for Alpine 3.22.0

As always, make sure to read Upgrading Alpine to a new major release when upgrading to a new release.

If you experience any issues with the upgrade, please let us know and file an issue in our repositories.

Significant changes

apk-tools

This release is the last release using apk-tools v2.14. The next Alpine v3.23 will include apk-tools v3. The packages and index format are still using the legacy v2 format.

There are a number of new changes in the new apk-tools release. To test apk-tools v3, upgrade to Alpine edge, enable the testing repository and install apk-tools3.

Note: TODO: if edge upgrades to apk-tools 3, remove the testing repo and apk-tools3 package mention

KDE Plasma

The X11 session for KDE Plasma has been removed. If you had plasma-workspace-x11 installed make sure to remove it from /etc/apk/world. Wayland is the only available option now.

SDL

sdl3 and sdl2-compat were moved to the community repository and are now the default SDL provider. To force the installation of sdl2, use apk add sdl2.

Adwaita Fonts

As a result of GNOME's switch to adwaita-fonts, the default font for GTK-based applications (e.g. vte3 or libadwaita Applications) was changed. If you want to revert or override the fonts, you can use:

$ apk add font-cantarell font-adobe-source-code-pro
$ gsettings set org.gnome.desktop.interface font-name 'Cantarell 11'
$ gsettings set org.gnome.desktop.interface monospace-font-name 'Source Code Pro 11'

adwaita-fonts is pulled in as a dependency of some packages since it broke the default behaviour for various applications.

GeoClue

Since Mozilla Location Services (MLS), which were used as the geolocation service in geoclue, has been retired by Mozilla, Alpine switched to beaconDB as the default geolocation provider. !76764

BIRD Routing Daemon

The bird routing daemon package has been upgrade to version 3 which introduces a new multi-threaded architecture. A side effect of this change is significantly increased memory consumption of the daemon. This update is configuration-compatible with BIRD v2 but there are some behavioral backwards incompatibilities. Users should read the migration guide. Notably the format of show route all has changed as has the format of the logs, which may impact scripts and automation that consume those outputs. Users who require BIRD v2 should install the bird2 package instead.

Note-worthy updates

As always, many packages were upgraded. Make sure to read the individual release notes of the projects you use.

• Linux TODO
• busybox TODO
• GCC TODO
• LLVM TODO
• Go TODO
• Rust TODO
• PHP TODO
• GNOME TODO
• KDE Plasma TODO
• LXQt TODO
• Qt TODO
• wlroots TODO
• ISC BIND 9.20.TODO
• BIRD 3.1.TODO

LLVM

LLVM 20 is available as llvm/clang (or llvm20/clang20 explictly) additionally to LLVM 19, 18, 17, 16 and 15. (!80901, !82502)

LLD is now also splitted per version and is available as lld20 (default for lld), lld19 and lld18. (!81774)

Significant removals

LXD

LXD was moved to the testing repository and is therefore not available on Alpine Linux 3.22. It was deprecated in favor of incus and incus-feature (feature branch).

Take a look at the Migration Guide on how to migrate from LXD to Incus using the incus-conversion or incus-feature-conversion package.

Qt 5

On 26th of May 2025, Qt 5 will be unmaintained upstream. Therefore we're removing unused libraries from our repositories and are migrating the remaining packages to Qt 6.

Applications that still use Qt 5 libraries won't be removed, but libraries without consumers in our repository will.

For more information, see Issue #17114.