Draft Release Notes for Alpine 3.23.0: Difference between revisions

Latest revision as of 19:56, 29 August 2025

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.

Note: We're beginning to work on the roadmap for Alpine Linux v3.23. To view the upcoming changes, see #17294.

Important changes

apk-tools v3

After 5 years of development in the master 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 libapk.

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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the official announcement for more details

linux-stable replaces linux-edge

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

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

If you had linux-edge installed, apk automatically installs linux-stable as a replacement. There is a reasonably amount of kernel config differences, if you need a config option that existed previously in linux-edge, please open a issue to add the required option to linux-lts. Also this change might involve manual boot loader configuration, as the kernel has been renamed and follows 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 TODO
busybox TODO
Deno TODO
GCC TODO
GNOME TODO
Go TODO
ISC BIND TODO
KDE Plasma TODO
Linux TODO
LLVM TODO
LXQt TODO
nginx TODO
NodeJS TODO (LTS)
PHP TODO
Qt TODO
Ruby TODO
Rust TODO
wlroots TODO
zigbee2mqtt TODO
ffmpeg TODO

Significant removals

rssh

rssh package has been removed due to the dead upstream.

@@ Line 2: / Line 2: @@
 If you experience any issues with the upgrade, please let us know and file an issue in our repositories.
+{{Note|We're beginning to work on the roadmap for Alpine Linux v3.23. To view the upcoming changes, see {{Issue|17294}}.}}
 == Important changes ==
-=== apk-tools ===
+=== {{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
-{{Note|TODO: we will move to apk v3}}
+=== /usr merge ===
-=== linux-stable replaces linux-edge ===
+New installations are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-09-01-usr-merge.html| official announcement] for more details
-It follows Linux's stable releases and otherwise has an identical configuration as linux-lts.
+=== {{Pkg|linux-stable}} replaces {{Pkg|linux-edge}} ===
-There are kernel config differences now, if you need a config option, please open a issue to add the required option to linux-lts.
+For years, {{Pkg|linux-lts}} and {{Pkg|linux-edge}} grew apart and developed their own kernel configs, different architectures, etc.
-This might require manual interaction depending on your boot loader.
+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 ==
@@ Line 42: / Line 68: @@
 * wlroots TODO
 * zigbee2mqtt TODO
+* ffmpeg TODO
 == Significant removals ==
+<!--
+=== {{Pkg|binutils-gold}} removed ===
+{{Note|TODO: not done yet and maybe not in 3.23}}
+The gold linker got deprecated by upstream on February 2025 and in Alpine v3.23 we removed it from our repositories.
+Previously this has been hold because of Go's use of the gold linker for ARM architectures, but these days the default ld linker works as expected.
+<hr><center>[[Release Notes for Alpine 3.22.0|← Previous page: Release Notes for Alpine 3.22.0]]</center>
+-->
+=== rssh ===
+rssh package has been removed due to the dead upstream.