Release Notes for Alpine 3.23.0

2025-12-02T00:39:37Z

Ayakael: Add .NET 10

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.

== Important changes ==

=== {{pkg|apk-tools}} v3 ===

After 5 years of development in the <code>master</code> branch of apk-tools, apk v3 is now ready for Alpine v3.23.0. This should be a safe and seamless upgrade from apk v2, but might has some breaking changes if you use <code>libapk</code>.

Note that we will only transition the package manager to v3, but will keep the v2 index and package format. We plan to move to the v3 index and package format after Alpine v3.23.

For more information, take a look at the release notes of apk v3: TODO

=== /usr merge ===

New installations can opt-in to being /usr-merged, by setting the <code>BOOTSTRAP_USR_MERGED</code> environment variable to <code>1</code> before running <code>setup-disk</code>. Manual migration is also possible by installing the <code>merge-usr</code> package and running its binary as root. For more details see the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement].

=== {{Pkg|linux-stable}} replaces {{Pkg|linux-edge}} ===

For years, {{Pkg|linux-lts}} and {{Pkg|linux-edge}} grew apart and developed their own kernel configs, different architectures, etc.

Now {{Pkg|linux-edge}} gets replaced with {{Pkg|linux-stable}} which has the identical configuration as {{Pkg|linux-lts}}, but follows the stable releases instead of the long-term releases (see https://kernel.org/).

If you had {{Pkg|linux-edge}} installed, apk automatically installs {{Pkg|linux-stable}} as a replacement. There is a reasonably amount of kernel config differences, if you need a config option that existed previously in {{Pkg|linux-edge}}, please open a issue to add the required option to {{Pkg|linux-lts}}. Also this change might involve manual boot loader configuration, as the kernel has been renamed and follows {{Pkg|linux-lts}}' packaging recipe.

== Significant changes ==

=== Static binaries are built as PIE ===

{{Note|TODO: https://gitlab.alpinelinux.org/alpine/aports/-/issues/17294#note_524739}}

=== LLVM metapackage ===

{{Note|TODO}}

=== nftrules ===

{{Note|TODO: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/67137}}

=== curl HTTP/3 ===

{{Note|TODO: https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/89382}}

== Note-worthy updates ==

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

* BIRD 3.1.4
* busybox 1.37.0
* Deno 2.3.1
* ffmpeg 8
* GCC 15.2.0
* GNOME 49
* Go 1.25
* ISC BIND 9.20.16
* ISC Kea 3.0.3
* KDE Plasma 6.5.2
* Linux 6.18
* LLVM 21.1.2
* LXQt 2.30
* .NET 10
* nginx 1.28
* NodeJS 24.11.1 (LTS)
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

=== LLVM 21 ===

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

=== GNOME 49 ===

https://release.gnome.org/49/

* We kept gnome-session (and gdm) at 48 because of the [https://release.gnome.org/49/developers/index.html#stronger-systemd-dependencies stricter systemd dependency] ({{Issue|17514}})
* Our gdk-pixbuf didn't enable the glycin sandboxing library yet ({{Issue|17550}})

=== ffmpeg 8 ===

The {{Pkg|ffmpeg}} package got upgraded from version 6 to 8.

Most consumers of ffmpeg are now built against ffmpeg 8, but some packages might still use ffmpeg 6 or 7, depending on its API compatability. Therefore the {{Pkg|ffmpeg6}} and {{Pkg|ffmpeg7}} packages are also still available.

Also note that {{Pkg|ffmpeg4}} got removed and all consumers were migrated to at least ffmpeg 6.

=== ifstate 2 ===

The declarative network configuration tool {{Pkg|ifstate}} has been upgraded from version 1.x to version 2. It is not possible to use the old configuration file of ifstate 1.x with ifstate 2.x! The configuration file '''must''' be adapted to the new schema and file name to prevent breaking the host's network the next time it is booted! More information about the required config changes can be found in the [https://ifstate.net/2.2/docs/upgrades/#ifstate-20 ifstate documentation].

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== LLVM 17 ===

=== rssh ===

rssh package has been removed due to the dead upstream.

<hr><center>[[Release Notes for Alpine 3.22.0|← Previous page: Release Notes for Alpine 3.22.0]]</center>

Alpine Linux - User contributions [en]

Release Notes for Alpine 3.23.0