Alpine Linux - User contributions [en]

Draft Release Notes for Alpine 3.24.0

2026-04-18T09:03:21Z

Fossdd: /* Significant package removals */ librewolf

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

{{Note|TODO}}

=== gdk-pixbuf uses glycin/glycin loaders got split ===

{{Note|TODO}}

=== Python setuptools 82.0.0 removed pkg_resources ===

py3-setuptools has been upgraded to 82.0.0, [https://setuptools.pypa.io/en/latest/history.html#v82-0-0 which removed pkg_resources]. Any project that still depends on it will no longer work and should migrate to its successors.

=== qemu-binfmt service deprecated ===

The <code>qemu-binfmt</code> service from the package <code>qemu-openrc</code> is deprecated, in favor of <code>binfmt.d</code> config files from user mode qemu packages (eg. <code>qemu-aarch64 qemu-x86_64</code>) combined with the <code>binfmt</code> service.

If you are using <code>qemu-binfmt</code>, run:
{{Cmd|# rc-update del qemu-binfmt && rc-update add binfmt}}

Contrary to the behavior of <code>qemu-binfmt</code>, the new default configuration prevents setuid programs from granting privileges. If you need to execute setuid programs via qemu:

* make sure you understand the implications: with this configuration, any user with execute access to any foreign-architecture setuid binary can execute arbitrary code with the privileges of that binary
* if you accept the risks, copy <code>/usr/lib/binfmt.d/qemu-*.conf</code> to <code>/etc/binfmt.d</code>, edit to add the <code>C</code> flag, and restart binfmt.

See [https://docs.kernel.org/admin-guide/binfmt-misc.html Kernel admin guide - binfmt] for more information about the <code>C</code> (<code>credentials</code>) flag.

== Note-worthy package 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

=== wlroots 0.20 ===

{{Note|TODO: {{MR|97598}}}}

== Significant package removals ==



=== py3-six ===

{{Note|TODO https://gitlab.alpinelinux.org/alpine/aports/-/work_items/17822}}

=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

=== libsoup 2 ===

{{Note|TODO}}

=== librewolf ===

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

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

[[Category:News]]

Draft Release Notes for Alpine 3.24.0

2026-03-02T11:30:10Z

Fossdd: /* Significant package removals */

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

{{Note|TODO}}

=== gdk-pixbuf uses glycin/glycin loaders got split ===

{{Note|TODO}}

=== Python setuptools 82.0.0 removed pkg_resources ===

py3-setuptools has been upgraded to 82.0.0, [https://setuptools.pypa.io/en/latest/history.html#v82-0-0 which removed pkg_resources]. Any project that still depends on it will no longer work and should migrate to its successors.

=== qemu-binfmt service deprecated ===

The <code>qemu-binfmt</code> service from the package <code>qemu-openrc</code> is deprecated, in favor of <code>binfmt.d</code> config files from user mode qemu packages (eg. <code>qemu-aarch64 qemu-x86_64</code>) combined with the <code>binfmt</code> service.

If you are using <code>qemu-binfmt</code>, run:
{{Cmd|# rc-update del qemu-binfmt && rc-update add binfmt}}

Contrary to the behavior of <code>qemu-binfmt</code>, the new default configuration prevents setuid programs from granting privileges. If you need to execute setuid programs via qemu:

* make sure you understand the implications: with this configuration, any user with execute access to any foreign-architecture setuid binary can execute arbitrary code with the privileges of that binary
* if you accept the risks, copy <code>/usr/lib/binfmt.d/qemu-*.conf</code> to <code>/etc/binfmt.d</code>, edit to add the <code>C</code> flag, and restart binfmt.

See [https://docs.kernel.org/admin-guide/binfmt-misc.html Kernel admin guide - binfmt] for more information about the <code>C</code> (<code>credentials</code>) flag.

== Note-worthy package 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

=== wlroots 0.20 ===

{{Note|TODO: {{MR|97598}}}}

== Significant package removals ==



=== py3-six ===

{{Note|TODO https://gitlab.alpinelinux.org/alpine/aports/-/work_items/17822}}

=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

=== libsoup 2 ===

{{Note|TODO}}

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

[[Category:News]]

Draft Release Notes for Alpine 3.24.0

2026-02-16T15:07:27Z

Fossdd:

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

{{Note|TODO}}

=== gdk-pixbuf uses glycin/glycin loaders got split ===

{{Note|TODO}}

=== Python setuptools 82.0.0 removed pkg_resources ===

py3-setuptools has been upgraded to 82.0.0, [https://setuptools.pypa.io/en/latest/history.html#v82-0-0 which removed pkg_resources]. Any project that still depends on it will no longer work and should migrate to its successors.

=== qemu-binfmt service deprecated ===

The <code>qemu-binfmt</code> service from the package <code>qemu-openrc</code> is deprecated, in favor of <code>binfmt.d</code> config files from user mode qemu packages (eg. <code>qemu-aarch64 qemu-x86_64</code>) combined with the <code>binfmt</code> service.

If you are using <code>qemu-binfmt</code>, run:
{{Cmd|# rc-update del qemu-binfmt && rc-update add binfmt}}

Contrary to the behavior of <code>qemu-binfmt</code>, the new default configuration prevents setuid programs from granting privileges. If you need to execute setuid programs via qemu:

* make sure you understand the implications: with this configuration, any user with execute access to any foreign-architecture setuid binary can execute arbitrary code with the privileges of that binary
* if you accept the risks, copy <code>/usr/lib/binfmt.d/qemu-*.conf</code> to <code>/etc/binfmt.d</code>, edit to add the <code>C</code> flag, and restart binfmt.

See [https://docs.kernel.org/admin-guide/binfmt-misc.html Kernel admin guide - binfmt] for more information about the <code>C</code> (<code>credentials</code>) flag.

== Note-worthy package 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

=== wlroots 0.20 ===

{{Note|TODO: {{MR|97598}}}}

== Significant package removals ==



=== py3-six ===

{{Note|TODO https://gitlab.alpinelinux.org/alpine/aports/-/work_items/17822}}

=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

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

[[Category:News]]

Kernels

2026-01-29T14:19:58Z

Fossdd:

Alpine Linux has several kernels (see {{Pkg|linux-*}}), designed to suit different situations.

* {{Pkg|linux-lts}} — Long-term support kernel, configured for a generous selection of hardware.
* {{Pkg|linux-virt}} — Long-term support kernel, configured for VM guests (disables most hardware in favor of a commonly-virtualized subset of drivers).
* {{Pkg|linux-stable}} — Stable kernel, configured for a generous selection of hardware
** only supported in <code>community</code>.
** For Alpine Linux 3.22 and older, there was {{pkg|linux-edge|branch=v3.21|arch=}}; see Release Notes for Alpine 3.23.0: [[Release_Notes_for_Alpine_3.23.0#linux-stable_replaces_linux-edge |linux-stable replaces linux-edge]].
* {{pkg|linux-rpi|arch=}} — Raspberry Pi's kernel, configured for the Raspberry Pi.
** For Alpine Linux 3.18 and older, there is also {{pkg|linux-rpi2|branch=v3.18|arch=}} and {{pkg|linux-rpi4|branch=v3.18|arch=}}, optimized for the Raspberry Pi 2 and 4, respectively.
* {{Pkg|linux-openpax}} — Kernel with OpenPAX patches that provide a layer of defense against memory safety-related vulnerabilities
** only supported in <code>community</code>.

For installing a custom kernel, see [[Custom Kernel]]. To select a specific kernel or firmware packages during installation from the Alpine ISO, simply install the desired kernel flavor and firmware packages with {{ic|apk add}} before running {{ic|setup-alpine}}.

== Firmware ==

The {{Pkg|linux-firmware}} meta-package is included in the [[Installation|default installation]] and depends on all firmware. It is a large download and due to this reason, installation of this package can produce errors on [[Installation#Diskless Mode|diskless]] or [[Installation#Data Disk Mode|data disk]] modes. If such errors occur, switch to [[Installation#System Disk Mode|system disk]] mode.

You may be better served by installing only the firmware that you need (see {{Pkg|linux-firmware-*}}), or {{Pkg|linux-firmware-none}} if you do not require any firmware. If you are unsure which firmware you need, boot with no firmware installed, and then run the command below to to get an idea. {{Cmd|<nowiki># dmesg|grep firmware</nowiki>}}

Be aware that most firmware is non-free.

[[Alpine kernel module support|Alpine Kernel Module Support]] (AKMS) page has information about the out-of-tree kernel module driver packages available in Alpine Linux and [[Alpine kernel module support#Using AKMS|how to use]] them.

== Experimental Kernels ==

Some kernels are not well tested and are therefore only available in the testing repository. Use at your own risk.

* {{pkg|linux-asahi|arch=aarch64}} — Apple Silicon devices, see https://asahilinux.org/
* {{pkg|linux-elm|arch=aarch64}} — Elm chromebooks
* {{pkg|linux-gru|arch=aarch64}} — Gru chromebooks
* {{Pkg|linux-eswin}} — [https://github.com/jmontleon/linux-eswin Linux lts kernel] - RISC-V
* {{pkg|linux-sophgo|arch=riscv64}} — Sophgo RISC-V SoC's
* {{pkg|linux-p550|arch=riscv64}} — SiFive P550 RISC-V SoC's
* {{pkg|linux-starfive|arch=riscv64}} — Starfive RISC-V SoC's
* {{pkg|linux-jh7100|arch=riscv64}} — Starfive JH7100 SoC
* {{pkg|linux-spacemit|arch=riscv64}} — SpacemiT RISC-V SoC's

== See also ==

* [[Custom Kernel]]
* [[How to build the Alpine Linux kernel]]
* [[Kernel_live_patching|Kernel Live Patching (KLP)]]
* [https://wiki.archlinux.org/title/Kernel Kernel - Archwiki]

[[category:Kernel]]

Draft Release Notes for Alpine 3.24.0

2026-01-13T20:40:35Z

Fossdd: /* Significant removals */

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

{{Note|TODO}}

=== gdk-pixbuf uses glycin/glycin loaders got split ===

{{Note|TODO}}

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

== Significant removals ==



=== py3-six ===

{{Note|TODO https://gitlab.alpinelinux.org/alpine/aports/-/work_items/17822}}

=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

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

[[Category:News]]

Draft Release Notes for Alpine 3.24.0

2026-01-12T14:10:17Z

Fossdd: /* Significant changes */

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

{{Note|TODO}}

=== gdk-pixbuf uses glycin/glycin loaders got split ===

{{Note|TODO}}

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

== Significant removals ==



=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

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

[[Category:News]]

Draft Release Notes for Alpine 3.24.0

2026-01-12T14:09:53Z

Fossdd: /* Significant removals */

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

=== COSMIC 1 ===

This release makes the COSMIC desktop available in community as {{pkg|cosmic*}} including {{pkg|xdg-desktop-portal-cosmic*}}.

== Significant removals ==



=== More GTK 2 removals ===

{{Note|TODO}}

=== More Qt5 removals ===

{{Note|TODO}}

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

[[Category:News]]

Draft Release Notes for Alpine 3.24.0

2025-12-20T20:15:51Z

Fossdd: /* Significant changes */

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

=== GTK+ 3.0 moved to community ===

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

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

[[Category:News]]

Kernels

2025-12-03T19:40:45Z

Fossdd:

Alpine Linux has several kernels (see {{Pkg|linux-*}}) designed to suit different situations.

* {{Pkg|linux-lts}} — Long-term support kernel, configured for a generous selection of hardware
** {{Pkg|linux-virt}} — Long-term support kernel, configured for VM guests (disables most hardware in favor of a commonly-virtualized subset of drivers)
* {{Pkg|linux-stable}} — Stable kernel, configured for a generous selection of hardware Only supported in <code>community</code>. For Alpine 3.22 and older there was {{pkg|linux-edge|branch=v3.21|arch=}}, see [[Release_Notes_for_Alpine_3.23.0#linux-stable_replaces_linux-edge]]

* {{pkg|linux-rpi|arch=}} — Raspberry Pi's kernel, configured for the Raspberry Pi. For Alpine 3.18 and older there is also {{pkg|linux-rpi2|branch=v3.18|arch=}} and {{pkg|linux-rpi4|branch=v3.18|arch=}} optimized for the Raspberry Pi 2 and 4 respectively.
* {{Pkg|linux-openpax}} — Kernel with OpenPAX patches which provide a layer of defense against memory safety-related vulnerabilities. Only supported in <code>community</code>

For installing a custom kernel, see [[Custom Kernel]]. To select a specific kernel or firmware packages during installation from the Alpine ISO, simply install the desired kernel flavor and firmware packages with {{ic|apk add}} before running {{ic|setup-alpine}}.

== Firmware ==

The {{Pkg|linux-firmware}} meta-package is included in the [[Installation|default installation]], and depends on all firmware. It is a large download. You may be better served by installing only the firmware you need (see {{Pkg|linux-firmware-*}}), or {{Pkg|linux-firmware-none}} if you do not require any firmware. If you're unsure which firmware you need, boot with no firmware installed and run {{ic|dmesg | grep firmware}} to get an idea. Be aware that most firmware is non-free.

== Experimental Kernels ==

Some kernels are not well tested and are therefor only available in the testing repository. Use at your own risk.

* {{pkg|linux-asahi|arch=aarch64}} — Apple Silicon devices, see https://asahilinux.org/
* {{pkg|linux-elm|arch=aarch64}} — Elm chromebooks
* {{pkg|linux-gru|arch=aarch64}} — Gru chromebooks
* {{Pkg|linux-eswin}} — [https://github.com/jmontleon/linux-eswin Linux lts kernel] - RISC-V
* {{pkg|linux-sophgo|arch=riscv64}} — Sophgo RISC-V SoC's
* {{pkg|linux-p550|arch=riscv64}} — SiFive P550 RISC-V SoC's
* {{pkg|linux-starfive|arch=riscv64}} — Starfive RISC-V SoC's
* {{pkg|linux-jh7100|arch=riscv64}} — Starfive JH7100 SoC
* {{pkg|linux-spacemit|arch=riscv64}} — SpacemiT RISC-V SoC's

== See also ==

* [[Custom Kernel]]
* [[How to build the Alpine Linux kernel]]
* [https://wiki.archlinux.org/title/Kernel Kernel - Archwiki]

[[category:Kernel]]

Kernels

2025-12-03T19:40:14Z

Fossdd:

Alpine Linux has several kernels (see {{Pkg|linux-*}}) designed to suit different situations.

* {{Pkg|linux-lts}} — Long-term support kernel, configured for a generous selection of hardware
** {{Pkg|linux-virt}} — Long-term support kernel, configured for VM guests (disables most hardware in favor of a commonly-virtualized subset of drivers)
* {{Pkg|linux-stable}} — Stable kernel, configured for a generous selection of hardware Only supported in <code>community</code>. For Alpine 3.22 and older there was {{pkg|linux-edge|branch=v3.21|arch=}}, see [[Release_Notes_for_Alpine_3.23.0#linux-stable_replaces_linux-edge]]

* {{pkg|linux-rpi|arch=}} — Raspberry Pi's kernel, configured for the Raspberry Pi. For Alpine 3.18 and older there is also {{pkg|linux-rpi2|branch=v3.18|arch=}} and {{pkg|linux-rpi4|branch=v3.18|arch=}} optimized for the Raspberry Pi 2 and 4 respectively.
* {{Pkg|linux-openpax}} — Kernel with OpenPAX patches which provide a layer of defense against memory safety-related vulnerabilities.

For installing a custom kernel, see [[Custom Kernel]]. To select a specific kernel or firmware packages during installation from the Alpine ISO, simply install the desired kernel flavor and firmware packages with {{ic|apk add}} before running {{ic|setup-alpine}}.

== Firmware ==

The {{Pkg|linux-firmware}} meta-package is included in the [[Installation|default installation]], and depends on all firmware. It is a large download. You may be better served by installing only the firmware you need (see {{Pkg|linux-firmware-*}}), or {{Pkg|linux-firmware-none}} if you do not require any firmware. If you're unsure which firmware you need, boot with no firmware installed and run {{ic|dmesg | grep firmware}} to get an idea. Be aware that most firmware is non-free.

== Experimental Kernels ==

Some kernels are not well tested and are therefor only available in the testing repository. Use at your own risk.

* {{pkg|linux-asahi|arch=aarch64}} — Apple Silicon devices, see https://asahilinux.org/
* {{pkg|linux-elm|arch=aarch64}} — Elm chromebooks
* {{pkg|linux-gru|arch=aarch64}} — Gru chromebooks
* {{Pkg|linux-eswin}} — [https://github.com/jmontleon/linux-eswin Linux lts kernel] - RISC-V
* {{pkg|linux-sophgo|arch=riscv64}} — Sophgo RISC-V SoC's
* {{pkg|linux-p550|arch=riscv64}} — SiFive P550 RISC-V SoC's
* {{pkg|linux-starfive|arch=riscv64}} — Starfive RISC-V SoC's
* {{pkg|linux-jh7100|arch=riscv64}} — Starfive JH7100 SoC
* {{pkg|linux-spacemit|arch=riscv64}} — SpacemiT RISC-V SoC's

== See also ==

* [[Custom Kernel]]
* [[How to build the Alpine Linux kernel]]
* [https://wiki.archlinux.org/title/Kernel Kernel - Archwiki]

[[category:Kernel]]

Kernels

2025-12-03T19:40:07Z

Fossdd:

Alpine Linux has several kernels (see {{Pkg|linux-*}}) designed to suit different situations.

* {{Pkg|linux-lts}} — Long-term support kernel, configured for a generous selection of hardware
** {{Pkg|linux-virt}} — Long-term support kernel, configured for VM guests (disables most hardware in favor of a commonly-virtualized subset of drivers)
* {{Pkg|linux-stable}} — Stable kernel, configured for a generous selection of hardware Only supported in <code>community</code>. For Alpine 3.21 and older there was {{pkg|linux-edge|branch=v3.21|arch=}}, see [[Release_Notes_for_Alpine_3.23.0#linux-stable_replaces_linux-edge]]

* {{pkg|linux-rpi|arch=}} — Raspberry Pi's kernel, configured for the Raspberry Pi. For Alpine 3.18 and older there is also {{pkg|linux-rpi2|branch=v3.18|arch=}} and {{pkg|linux-rpi4|branch=v3.18|arch=}} optimized for the Raspberry Pi 2 and 4 respectively.
* {{Pkg|linux-openpax}} — Kernel with OpenPAX patches which provide a layer of defense against memory safety-related vulnerabilities.

For installing a custom kernel, see [[Custom Kernel]]. To select a specific kernel or firmware packages during installation from the Alpine ISO, simply install the desired kernel flavor and firmware packages with {{ic|apk add}} before running {{ic|setup-alpine}}.

== Firmware ==

The {{Pkg|linux-firmware}} meta-package is included in the [[Installation|default installation]], and depends on all firmware. It is a large download. You may be better served by installing only the firmware you need (see {{Pkg|linux-firmware-*}}), or {{Pkg|linux-firmware-none}} if you do not require any firmware. If you're unsure which firmware you need, boot with no firmware installed and run {{ic|dmesg | grep firmware}} to get an idea. Be aware that most firmware is non-free.

== Experimental Kernels ==

Some kernels are not well tested and are therefor only available in the testing repository. Use at your own risk.

* {{pkg|linux-asahi|arch=aarch64}} — Apple Silicon devices, see https://asahilinux.org/
* {{pkg|linux-elm|arch=aarch64}} — Elm chromebooks
* {{pkg|linux-gru|arch=aarch64}} — Gru chromebooks
* {{Pkg|linux-eswin}} — [https://github.com/jmontleon/linux-eswin Linux lts kernel] - RISC-V
* {{pkg|linux-sophgo|arch=riscv64}} — Sophgo RISC-V SoC's
* {{pkg|linux-p550|arch=riscv64}} — SiFive P550 RISC-V SoC's
* {{pkg|linux-starfive|arch=riscv64}} — Starfive RISC-V SoC's
* {{pkg|linux-jh7100|arch=riscv64}} — Starfive JH7100 SoC
* {{pkg|linux-spacemit|arch=riscv64}} — SpacemiT RISC-V SoC's

== See also ==

* [[Custom Kernel]]
* [[How to build the Alpine Linux kernel]]
* [https://wiki.archlinux.org/title/Kernel Kernel - Archwiki]

[[category:Kernel]]

Draft Release Notes for Alpine 3.24.0

2025-12-03T12:52:40Z

Fossdd:

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

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

Release Notes for Alpine 3.23.0

2025-12-03T12:49:29Z

Fossdd: /* Significant removals */

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules subpackages ===

nftables rulesets are now packaged in <code>$pkgname-nftrules</code> subpackages, which contain rules for their individual packages in <code>/usr/share/nftables.avail/</code>. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== udev rules subpackages ===

Most udev rules were moved from main packages to their subpackages <code>$pkgname-udev</code>. It will be automatically installed if the system has <code>udev</code> installed, so it shouldn't require any manual intervention, but simplifies systems without udev.

=== systemd service subpackages ===

Although we don't have systemd packaged, many packages now have subpackages <code>$pkgname-systemd</code>, that contain systemd services. This will have no effect on systems, but simplifies any future integrations with systemd in Alpine and for [https://postmarketos.org/blog/2025/06/22/v25.06-release/#introduction postmarketOS]. There is no plan to move the default init system away from OpenRC.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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.2
* KDE Plasma 6.5.3
* Linux 6.18
* LLVM 21.1.2
* LXQt 2.30
* .NET 10
* nginx 1.28
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}})

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

<hr><center>[[Release Notes for Alpine 3.22.0|← Previous page: Release Notes for Alpine 3.22.0]] — [[Draft Release Notes for Alpine 3.24.0|Next page: Release Notes for Alpine 3.24.0 →]]</center>

Release Notes for Alpine 3.23.0

2025-12-03T12:49:16Z

Fossdd: /* Note-worthy updates */

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules subpackages ===

nftables rulesets are now packaged in <code>$pkgname-nftrules</code> subpackages, which contain rules for their individual packages in <code>/usr/share/nftables.avail/</code>. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== udev rules subpackages ===

Most udev rules were moved from main packages to their subpackages <code>$pkgname-udev</code>. It will be automatically installed if the system has <code>udev</code> installed, so it shouldn't require any manual intervention, but simplifies systems without udev.

=== systemd service subpackages ===

Although we don't have systemd packaged, many packages now have subpackages <code>$pkgname-systemd</code>, that contain systemd services. This will have no effect on systems, but simplifies any future integrations with systemd in Alpine and for [https://postmarketos.org/blog/2025/06/22/v25.06-release/#introduction postmarketOS]. There is no plan to move the default init system away from OpenRC.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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.2
* KDE Plasma 6.5.3
* Linux 6.18
* LLVM 21.1.2
* LXQt 2.30
* .NET 10
* nginx 1.28
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

<hr><center>[[Release Notes for Alpine 3.22.0|← Previous page: Release Notes for Alpine 3.22.0]] — [[Draft Release Notes for Alpine 3.24.0|Next page: Release Notes for Alpine 3.24.0 →]]</center>

Release Notes for Alpine 3.23.0

2025-12-03T12:47:36Z

Fossdd:

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules subpackages ===

nftables rulesets are now packaged in <code>$pkgname-nftrules</code> subpackages, which contain rules for their individual packages in <code>/usr/share/nftables.avail/</code>. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== udev rules subpackages ===

Most udev rules were moved from main packages to their subpackages <code>$pkgname-udev</code>. It will be automatically installed if the system has <code>udev</code> installed, so it shouldn't require any manual intervention, but simplifies systems without udev.

=== systemd service subpackages ===

Although we don't have systemd packaged, many packages now have subpackages <code>$pkgname-systemd</code>, that contain systemd services. This will have no effect on systems, but simplifies any future integrations with systemd in Alpine and for [https://postmarketos.org/blog/2025/06/22/v25.06-release/#introduction postmarketOS]. There is no plan to move the default init system away from OpenRC.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

<hr><center>[[Release Notes for Alpine 3.22.0|← Previous page: Release Notes for Alpine 3.22.0]] — [[Draft Release Notes for Alpine 3.24.0|Next page: Release Notes for Alpine 3.24.0 →]]</center>

Release Notes for Alpine 3.22.0

2025-12-03T12:46:41Z

Fossdd:

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 ==

=== Preparations for /usr-merge ===

The work on /usr-merge has continued since last release. Precaution from [[Release_Notes_for_Alpine_3.21.0#Preparations_for_/usr-merge|previous release]] still apply.

== 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, [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge| upgrade to Alpine edge]], which already ships apk v3.

For more inforation about apk v3, take a look at it's release notes: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{pkg|plasma-workspace-x11|branch=v3.21|arch=}} installed make sure to remove it from {{path|/etc/apk/world}}. Wayland is the only available option now.

=== SDL ===

{{pkg|sdl3}} and {{pkg|sdl2-compat}} were moved to the community repository and are now the default SDL provider. To force the installation of {{pkg|sdl2}}, use <code>apk add sdl2</code>.

=== Adwaita Fonts ===

As a result of [https://release.gnome.org/48/#new-fonts GNOME's switch] to {{pkg|adwaita-fonts}}, the default font for GTK-based applications (e.g. {{pkg|vte3}} or {{pkg|libadwaita}} Applications) was changed. If you want to revert or override the fonts, you can use:

<pre>
$ 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'
</pre>

{{pkg|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, [https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693 has been retired by Mozilla], Alpine switched to [https://beacondb.net/ beaconDB] as the default geolocation provider. ({{MR|76764}})

=== BIRD Routing Daemon ===

The {{pkg|bird|repo=community}} routing daemon package has been upgrade to version 3 which introduces a new multi-threaded architecture. A side effect of this change is [https://trubka.network.cz/pipermail/bird-users/2024-December/017973.html 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 [https://gitlab.nic.cz/labs/bird/-/blob/stable-v3.0/doc/migration-bird3.md migration guide]. Notably the format of <tt>show route all</tt> 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 {{pkg|bird2|repo=community}} package instead.

=== Secure Boot and Gummiboot ===

{{pkg|secureboot-hook|repo=main}} (and its dependency {{pkg|efi-mkuki|repo=main}}), which is used to build and sign an Unified Kernel Image for Secure Boot, no longer works with {{pkg|gummiboot-efistub|repo=testing}}. The default EFI stub is now {{pkg|systemd-efistub|repo=main}} (don’t worry, it provides just the EFI stub files, nothing more), but you can also use {{pkg|stubbyboot-efistub|repo=community}}.

Provided you haven’t overwritten the <code>efistub_file</code> parameter in {{path|/etc/kernel-hooks.d/secureboot.conf}}, you won’t need to take any action when upgrading – it should install {{pkg|systemd-efistub|repo=main}} automatically and everything should work fine. Otherwise, check the configuration carefully.

The {{pkg|gummiboot-efistub|repo=testing}} package has been moved to the testing repository and it no longer provides the <code>efistub</code> provider. The Gummiboot upstream is gone (it was absorbed by systemd a long time ago) and some users have reported that it has not worked since Alpine v3.21.

=== nginx built with pcre2 ===

Since this release, {{pkg|nginx|repo=main}} and {{pkg|njs|repo=community}} are built with pcre2 (10.x) instead of the old pcre (8.x).

=== OpenRC User services ===

Experimental support for User services are currently available in [[OpenRC#User services|OpenRC]].

== 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
* busybox 1.37.0
* Deno 2.3.1
* dovecot 2.4
* GCC 14.2.0
* GNOME 48
* Go 1.24
* ISC BIND 9.20
* KDE Plasma 6.3
* Linux 6.12
* LLVM 20
* LXQt 2.2.0
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP 8.4
* Qt 6.8
* Ruby 3.4
* Rust 1.87
* wlroots 0.18
* zigbee2mqtt 2.3.0

=== LLVM ===

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

LLD is now also splitted per version and is available as {{pkg|lld20}} (default for {{pkg|lld}}), {{pkg|lld19}} and {{pkg|lld18}}. ({{MR|81774}})

=== woodpecker ===

The {{pkg|woodpecker|repo=community}} CI/CD package has been upgraded from 2.8.0 to 3.6.0. Between version 2.x -> 3.x several changes were made to Woodpecker's API and configuration.

[https://woodpecker-ci.org/migrations#300 2.x -> 3.x migration information can be found here.]

=== dovecot ===

The dovecot package have been upgraded from 2.3 to 2.4 which introduces breaking changes in the configuration format. See [https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html dovecot documentation] how to migrate.

== 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 {{pkg|incus}} and {{pkg|incus-feature}} (feature branch).

Take a look at the [https://linuxcontainers.org/incus/docs/main/howto/server_migrate_lxd/ Migration Guide] on how to migrate from LXD to Incus using the {{pkg|incus-conversion}} or {{pkg|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 {{Issue|17114}}.

=== Meilisearch ===

<code>meilisearch</code> in aports has not been maintained for a long time. It's removed from Alpine 3.22.

=== Botan 2 ===

Botan2 has reached End of Life and will not be part of 3.22 release

=== pcc (portable C compiler) ===

Unfortunately, upstream's website [https://marc.info/?l=pcc-list&m=170541815829299&w=2 has been offline since 2023-12-11] and hasn't come back online since. AFAIK, there isn't any good alternative source that we can use. The best one we were able to find is an unofficial [https://repo.or.cz/pcc.git repo.or.cz mirror].

As a consequence, other distros (e.g. [https://src.fedoraproject.org/rpms/pcc/c/6e04a3afcbdca49cb4f117e7febdf5ae67a3bed1?branch=rawhide Fedora]) have orphaned pcc and other distros (e.g. Debian) archive very ancient versions of pcc.

=== ruby-grpc ===

GRPC is a huge mess, and we lack the resources to support all its language bindings.

Due to this, we had to also remove ruby-pg_query and sqlint.

<hr><center>[[Release Notes for Alpine 3.21.0|← Previous page: Release Notes for Alpine 3.21.0]] — [[Release Notes for Alpine 3.23.0|Next page: Release Notes for Alpine 3.23.0 →]]</center>

[[Category:News]]

Draft Release Notes for Alpine 3.23.0

2025-12-03T12:46:21Z

Fossdd: Fossdd moved page Draft Release Notes for Alpine 3.23.0 to Release Notes for Alpine 3.23.0 over redirect: will be released today!

#REDIRECT [[Release Notes for Alpine 3.23.0]]

Release Notes for Alpine 3.23.0

2025-12-03T12:46:21Z

Fossdd: Fossdd moved page Draft Release Notes for Alpine 3.23.0 to Release Notes for Alpine 3.23.0 over redirect: will be released today!

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules subpackages ===

nftables rulesets are now packaged in <code>$pkgname-nftrules</code> subpackages, which contain rules for their individual packages in <code>/usr/share/nftables.avail/</code>. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== udev rules subpackages ===

Most udev rules were moved from main packages to their subpackages <code>$pkgname-udev</code>. It will be automatically installed if the system has <code>udev</code> installed, so it shouldn't require any manual intervention, but simplifies systems without udev.

=== systemd service subpackages ===

Although we don't have systemd packaged, many packages now have subpackages <code>$pkgname-systemd</code>, that contain systemd services. This will have no effect on systems, but simplifies any future integrations with systemd in Alpine and for [https://postmarketos.org/blog/2025/06/22/v25.06-release/#introduction postmarketOS]. There is no plan to move the default init system away from OpenRC.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

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

Release Notes for Alpine 3.23.0

2025-12-03T12:44:07Z

Fossdd: /* Significant changes */

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules subpackages ===

nftables rulesets are now packaged in <code>$pkgname-nftrules</code> subpackages, which contain rules for their individual packages in <code>/usr/share/nftables.avail/</code>. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== udev rules subpackages ===

Most udev rules were moved from main packages to their subpackages <code>$pkgname-udev</code>. It will be automatically installed if the system has <code>udev</code> installed, so it shouldn't require any manual intervention, but simplifies systems without udev.

=== systemd service subpackages ===

Although we don't have systemd packaged, many packages now have subpackages <code>$pkgname-systemd</code>, that contain systemd services. This will have no effect on systems, but simplifies any future integrations with systemd in Alpine and for [https://postmarketos.org/blog/2025/06/22/v25.06-release/#introduction postmarketOS]. There is no plan to move the default init system away from OpenRC.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

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

Draft Release Notes for Alpine 3.24.0

2025-12-03T12:36:11Z

Fossdd: Created page with "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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at Release Notes for Alpine 3.23.0.}} == Important changes == === /usr merge === New installations can opt..."

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|Alpine 3.24 is WIP, see https://gitlab.alpinelinux.org/groups/alpine/-/milestones/27 for important changes. For the latest release 3.23, look at [[Release Notes for Alpine 3.23.0]].}}

== Important changes ==

=== /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].

== Significant changes ==

== 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
* ffmpeg TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* ISC Kea TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* .NET TODO
* nginx TODO
* NodeJS TODO (LTS)
* OpenJDK TODO
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

== Significant removals ==

=== More Qt5 removals ===

{{Note|TODO}}

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

Release Notes for Alpine 3.23.0

2025-12-03T12:32:09Z

Fossdd:

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: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== /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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules ===

nftables rulesets are now packaged in `$pkgname-nftrules` subpackages, which contain rules for their individual packages in `/usr/share/nftables.avail/`. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

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

Release Notes for Alpine 3.22.0

2025-12-03T12:31:10Z

Fossdd: /* Significant changes */

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 ==

=== Preparations for /usr-merge ===

The work on /usr-merge has continued since last release. Precaution from [[Release_Notes_for_Alpine_3.21.0#Preparations_for_/usr-merge|previous release]] still apply.

== 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, [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge| upgrade to Alpine edge]], which already ships apk v3.

For more inforation about apk v3, take a look at it's release notes: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{pkg|plasma-workspace-x11|branch=v3.21|arch=}} installed make sure to remove it from {{path|/etc/apk/world}}. Wayland is the only available option now.

=== SDL ===

{{pkg|sdl3}} and {{pkg|sdl2-compat}} were moved to the community repository and are now the default SDL provider. To force the installation of {{pkg|sdl2}}, use <code>apk add sdl2</code>.

=== Adwaita Fonts ===

As a result of [https://release.gnome.org/48/#new-fonts GNOME's switch] to {{pkg|adwaita-fonts}}, the default font for GTK-based applications (e.g. {{pkg|vte3}} or {{pkg|libadwaita}} Applications) was changed. If you want to revert or override the fonts, you can use:

<pre>
$ 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'
</pre>

{{pkg|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, [https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693 has been retired by Mozilla], Alpine switched to [https://beacondb.net/ beaconDB] as the default geolocation provider. ({{MR|76764}})

=== BIRD Routing Daemon ===

The {{pkg|bird|repo=community}} routing daemon package has been upgrade to version 3 which introduces a new multi-threaded architecture. A side effect of this change is [https://trubka.network.cz/pipermail/bird-users/2024-December/017973.html 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 [https://gitlab.nic.cz/labs/bird/-/blob/stable-v3.0/doc/migration-bird3.md migration guide]. Notably the format of <tt>show route all</tt> 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 {{pkg|bird2|repo=community}} package instead.

=== Secure Boot and Gummiboot ===

{{pkg|secureboot-hook|repo=main}} (and its dependency {{pkg|efi-mkuki|repo=main}}), which is used to build and sign an Unified Kernel Image for Secure Boot, no longer works with {{pkg|gummiboot-efistub|repo=testing}}. The default EFI stub is now {{pkg|systemd-efistub|repo=main}} (don’t worry, it provides just the EFI stub files, nothing more), but you can also use {{pkg|stubbyboot-efistub|repo=community}}.

Provided you haven’t overwritten the <code>efistub_file</code> parameter in {{path|/etc/kernel-hooks.d/secureboot.conf}}, you won’t need to take any action when upgrading – it should install {{pkg|systemd-efistub|repo=main}} automatically and everything should work fine. Otherwise, check the configuration carefully.

The {{pkg|gummiboot-efistub|repo=testing}} package has been moved to the testing repository and it no longer provides the <code>efistub</code> provider. The Gummiboot upstream is gone (it was absorbed by systemd a long time ago) and some users have reported that it has not worked since Alpine v3.21.

=== nginx built with pcre2 ===

Since this release, {{pkg|nginx|repo=main}} and {{pkg|njs|repo=community}} are built with pcre2 (10.x) instead of the old pcre (8.x).

=== OpenRC User services ===

Experimental support for User services are currently available in [[OpenRC#User services|OpenRC]].

== 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
* busybox 1.37.0
* Deno 2.3.1
* dovecot 2.4
* GCC 14.2.0
* GNOME 48
* Go 1.24
* ISC BIND 9.20
* KDE Plasma 6.3
* Linux 6.12
* LLVM 20
* LXQt 2.2.0
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP 8.4
* Qt 6.8
* Ruby 3.4
* Rust 1.87
* wlroots 0.18
* zigbee2mqtt 2.3.0

=== LLVM ===

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

LLD is now also splitted per version and is available as {{pkg|lld20}} (default for {{pkg|lld}}), {{pkg|lld19}} and {{pkg|lld18}}. ({{MR|81774}})

=== woodpecker ===

The {{pkg|woodpecker|repo=community}} CI/CD package has been upgraded from 2.8.0 to 3.6.0. Between version 2.x -> 3.x several changes were made to Woodpecker's API and configuration.

[https://woodpecker-ci.org/migrations#300 2.x -> 3.x migration information can be found here.]

=== dovecot ===

The dovecot package have been upgraded from 2.3 to 2.4 which introduces breaking changes in the configuration format. See [https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html dovecot documentation] how to migrate.

== 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 {{pkg|incus}} and {{pkg|incus-feature}} (feature branch).

Take a look at the [https://linuxcontainers.org/incus/docs/main/howto/server_migrate_lxd/ Migration Guide] on how to migrate from LXD to Incus using the {{pkg|incus-conversion}} or {{pkg|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 {{Issue|17114}}.

=== Meilisearch ===

<code>meilisearch</code> in aports has not been maintained for a long time. It's removed from Alpine 3.22.

=== Botan 2 ===

Botan2 has reached End of Life and will not be part of 3.22 release

=== pcc (portable C compiler) ===

Unfortunately, upstream's website [https://marc.info/?l=pcc-list&m=170541815829299&w=2 has been offline since 2023-12-11] and hasn't come back online since. AFAIK, there isn't any good alternative source that we can use. The best one we were able to find is an unofficial [https://repo.or.cz/pcc.git repo.or.cz mirror].

As a consequence, other distros (e.g. [https://src.fedoraproject.org/rpms/pcc/c/6e04a3afcbdca49cb4f117e7febdf5ae67a3bed1?branch=rawhide Fedora]) have orphaned pcc and other distros (e.g. Debian) archive very ancient versions of pcc.

=== ruby-grpc ===

GRPC is a huge mess, and we lack the resources to support all its language bindings.

Due to this, we had to also remove ruby-pg_query and sqlint.

<hr><center>[[Release Notes for Alpine 3.21.0|← Previous page: Release Notes for Alpine 3.21.0]] — [[Draft Release Notes for Alpine 3.23.0|Next page: Draft Release Notes for Alpine 3.23.0 →]]</center>

[[Category:News]]

Release Notes for Alpine 3.22.0

2025-12-03T12:30:43Z

Fossdd: /* Significant changes */

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 ==

=== Preparations for /usr-merge ===

The work on /usr-merge has continued since last release. Precaution from [[Release_Notes_for_Alpine_3.21.0#Preparations_for_/usr-merge|previous release]] still apply.

== 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, [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge| upgrade to Alpine edge]], which already ships apk v3.

Make sure to read the dedicated release notes for apk v3: https://gitlab.alpinelinux.org/alpine/apk-tools/-/releases/v3.0.0

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{pkg|plasma-workspace-x11|branch=v3.21|arch=}} installed make sure to remove it from {{path|/etc/apk/world}}. Wayland is the only available option now.

=== SDL ===

{{pkg|sdl3}} and {{pkg|sdl2-compat}} were moved to the community repository and are now the default SDL provider. To force the installation of {{pkg|sdl2}}, use <code>apk add sdl2</code>.

=== Adwaita Fonts ===

As a result of [https://release.gnome.org/48/#new-fonts GNOME's switch] to {{pkg|adwaita-fonts}}, the default font for GTK-based applications (e.g. {{pkg|vte3}} or {{pkg|libadwaita}} Applications) was changed. If you want to revert or override the fonts, you can use:

<pre>
$ 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'
</pre>

{{pkg|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, [https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693 has been retired by Mozilla], Alpine switched to [https://beacondb.net/ beaconDB] as the default geolocation provider. ({{MR|76764}})

=== BIRD Routing Daemon ===

The {{pkg|bird|repo=community}} routing daemon package has been upgrade to version 3 which introduces a new multi-threaded architecture. A side effect of this change is [https://trubka.network.cz/pipermail/bird-users/2024-December/017973.html 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 [https://gitlab.nic.cz/labs/bird/-/blob/stable-v3.0/doc/migration-bird3.md migration guide]. Notably the format of <tt>show route all</tt> 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 {{pkg|bird2|repo=community}} package instead.

=== Secure Boot and Gummiboot ===

{{pkg|secureboot-hook|repo=main}} (and its dependency {{pkg|efi-mkuki|repo=main}}), which is used to build and sign an Unified Kernel Image for Secure Boot, no longer works with {{pkg|gummiboot-efistub|repo=testing}}. The default EFI stub is now {{pkg|systemd-efistub|repo=main}} (don’t worry, it provides just the EFI stub files, nothing more), but you can also use {{pkg|stubbyboot-efistub|repo=community}}.

Provided you haven’t overwritten the <code>efistub_file</code> parameter in {{path|/etc/kernel-hooks.d/secureboot.conf}}, you won’t need to take any action when upgrading – it should install {{pkg|systemd-efistub|repo=main}} automatically and everything should work fine. Otherwise, check the configuration carefully.

The {{pkg|gummiboot-efistub|repo=testing}} package has been moved to the testing repository and it no longer provides the <code>efistub</code> provider. The Gummiboot upstream is gone (it was absorbed by systemd a long time ago) and some users have reported that it has not worked since Alpine v3.21.

=== nginx built with pcre2 ===

Since this release, {{pkg|nginx|repo=main}} and {{pkg|njs|repo=community}} are built with pcre2 (10.x) instead of the old pcre (8.x).

=== OpenRC User services ===

Experimental support for User services are currently available in [[OpenRC#User services|OpenRC]].

== 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
* busybox 1.37.0
* Deno 2.3.1
* dovecot 2.4
* GCC 14.2.0
* GNOME 48
* Go 1.24
* ISC BIND 9.20
* KDE Plasma 6.3
* Linux 6.12
* LLVM 20
* LXQt 2.2.0
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP 8.4
* Qt 6.8
* Ruby 3.4
* Rust 1.87
* wlroots 0.18
* zigbee2mqtt 2.3.0

=== LLVM ===

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

LLD is now also splitted per version and is available as {{pkg|lld20}} (default for {{pkg|lld}}), {{pkg|lld19}} and {{pkg|lld18}}. ({{MR|81774}})

=== woodpecker ===

The {{pkg|woodpecker|repo=community}} CI/CD package has been upgraded from 2.8.0 to 3.6.0. Between version 2.x -> 3.x several changes were made to Woodpecker's API and configuration.

[https://woodpecker-ci.org/migrations#300 2.x -> 3.x migration information can be found here.]

=== dovecot ===

The dovecot package have been upgraded from 2.3 to 2.4 which introduces breaking changes in the configuration format. See [https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html dovecot documentation] how to migrate.

== 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 {{pkg|incus}} and {{pkg|incus-feature}} (feature branch).

Take a look at the [https://linuxcontainers.org/incus/docs/main/howto/server_migrate_lxd/ Migration Guide] on how to migrate from LXD to Incus using the {{pkg|incus-conversion}} or {{pkg|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 {{Issue|17114}}.

=== Meilisearch ===

<code>meilisearch</code> in aports has not been maintained for a long time. It's removed from Alpine 3.22.

=== Botan 2 ===

Botan2 has reached End of Life and will not be part of 3.22 release

=== pcc (portable C compiler) ===

Unfortunately, upstream's website [https://marc.info/?l=pcc-list&m=170541815829299&w=2 has been offline since 2023-12-11] and hasn't come back online since. AFAIK, there isn't any good alternative source that we can use. The best one we were able to find is an unofficial [https://repo.or.cz/pcc.git repo.or.cz mirror].

As a consequence, other distros (e.g. [https://src.fedoraproject.org/rpms/pcc/c/6e04a3afcbdca49cb4f117e7febdf5ae67a3bed1?branch=rawhide Fedora]) have orphaned pcc and other distros (e.g. Debian) archive very ancient versions of pcc.

=== ruby-grpc ===

GRPC is a huge mess, and we lack the resources to support all its language bindings.

Due to this, we had to also remove ruby-pg_query and sqlint.

<hr><center>[[Release Notes for Alpine 3.21.0|← Previous page: Release Notes for Alpine 3.21.0]] — [[Draft Release Notes for Alpine 3.23.0|Next page: Draft Release Notes for Alpine 3.23.0 →]]</center>

[[Category:News]]

Release Notes for Alpine 3.23.0

2025-12-03T12:26:28Z

Fossdd:

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 ==

=== LLVM metapackage ===

Unversioned LLVM symlinks to their versioned components are now moved from their versioned LLVM package to a meta-package. This should have no impact on your usage.

=== nftrules ===

nftables rulesets are now packaged in `$pkgname-nftrules` subpackages, which contain rules for their individual packages in `/usr/share/nftables.avail/`. To enable rules, you can symlink the specific rule-files to `/etc/nftables.d/`. ({{Issue|16177}})

To install all available nftrules packages, you can install the metapackage {{Pkg|nftables-rulesets}}.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|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)
* OpenJDK 25
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* wlroots 0.19
* zigbee2mqtt 2.6.3

=== GCC 15 ===

We upgraded GCC from 14 to 15 and all packages have been built with GCC 15.

Make sure to read their release changes (https://gcc.gnu.org/gcc-15/changes.html) and porting guide (https://gcc.gnu.org/gcc-15/porting_to.html).

=== LLVM 21 ===

We upgraded our LLVM suite to 21.1.2. Older clang packages are still available for version 20. But we removed relevant LLVM/Clang packages that are no longer needed by our distribution packages. If you still need older versions, please port your software to newer LLVM versions or use third-party builds.

=== GNOME 49 ===

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

* We kept gnome-session (and gdm, and similar) 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 ===

Just as [[Release_Notes_for_Alpine_3.22.0#Qt_5|last release]], we removed more Qt5 libraries that were no longer used by our distribution packages. ({{Issue|17114}}

=== ffmpeg4 ===

We removed <code>ffmpeg4</code> from our repository and are only providing versions 6, 7 and 8.

=== rssh ===

rssh package has been removed due to the dead upstream.

=== ircservices ===

unmaintained upstream for years

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

Release Notes for Alpine 3.23.0

2025-12-01T23:27:28Z

Fossdd:

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.
* 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>

User:Fossdd

2025-12-01T14:12:08Z

Fossdd:

👋 Hi! I'm Achill!

== Contact ==
* E-Mail: <code>[mailto:achill@achill.org achill@achill.org]</code>
* Matrix: <code>[https://matrix.to/#/@achill:postmarketos.org @achill:postmarketos.org]</code>
* Fediverse: <code>[https://chaos.social/@fossdd @fossdd@chaos.social]</code>

== Other links ==
* [https://gitlab.alpinelinux.org/fossdd Alpine Linux GitLab]

Release Notes for Alpine 3.23.0

2025-11-26T12:14:00Z

Fossdd:

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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement] for more details.

=== {{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.12
* LLVM 21.1.2
* LXQt 2.30.
* 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.0/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>

Release Notes for Alpine 3.22.0

2025-10-18T16:23:40Z

Fossdd:

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 ==

=== Preparations for /usr-merge ===

The work on /usr-merge has continued since last release. Precaution from [[Release_Notes_for_Alpine_3.21.0#Preparations_for_/usr-merge|previous release]] still apply.

== 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, [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge| upgrade to Alpine edge]], which already ships apk v3.

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{pkg|plasma-workspace-x11|branch=v3.21|arch=}} installed make sure to remove it from {{path|/etc/apk/world}}. Wayland is the only available option now.

=== SDL ===

{{pkg|sdl3}} and {{pkg|sdl2-compat}} were moved to the community repository and are now the default SDL provider. To force the installation of {{pkg|sdl2}}, use <code>apk add sdl2</code>.

=== Adwaita Fonts ===

As a result of [https://release.gnome.org/48/#new-fonts GNOME's switch] to {{pkg|adwaita-fonts}}, the default font for GTK-based applications (e.g. {{pkg|vte3}} or {{pkg|libadwaita}} Applications) was changed. If you want to revert or override the fonts, you can use:

<pre>
$ 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'
</pre>

{{pkg|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, [https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693 has been retired by Mozilla], Alpine switched to [https://beacondb.net/ beaconDB] as the default geolocation provider. ({{MR|76764}})

=== BIRD Routing Daemon ===

The {{pkg|bird|repo=community}} routing daemon package has been upgrade to version 3 which introduces a new multi-threaded architecture. A side effect of this change is [https://trubka.network.cz/pipermail/bird-users/2024-December/017973.html 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 [https://gitlab.nic.cz/labs/bird/-/blob/stable-v3.0/doc/migration-bird3.md migration guide]. Notably the format of <tt>show route all</tt> 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 {{pkg|bird2|repo=community}} package instead.

=== Secure Boot and Gummiboot ===

{{pkg|secureboot-hook|repo=main}} (and its dependency {{pkg|efi-mkuki|repo=main}}), which is used to build and sign an Unified Kernel Image for Secure Boot, no longer works with {{pkg|gummiboot-efistub|repo=testing}}. The default EFI stub is now {{pkg|systemd-efistub|repo=main}} (don’t worry, it provides just the EFI stub files, nothing more), but you can also use {{pkg|stubbyboot-efistub|repo=community}}.

Provided you haven’t overwritten the <code>efistub_file</code> parameter in {{path|/etc/kernel-hooks.d/secureboot.conf}}, you won’t need to take any action when upgrading – it should install {{pkg|systemd-efistub|repo=main}} automatically and everything should work fine. Otherwise, check the configuration carefully.

The {{pkg|gummiboot-efistub|repo=testing}} package has been moved to the testing repository and it no longer provides the <code>efistub</code> provider. The Gummiboot upstream is gone (it was absorbed by systemd a long time ago) and some users have reported that it has not worked since Alpine v3.21.

=== nginx built with pcre2 ===

Since this release, {{pkg|nginx|repo=main}} and {{pkg|njs|repo=community}} are built with pcre2 (10.x) instead of the old pcre (8.x).

=== OpenRC User services ===

Experimental support for User services are currently available in [[OpenRC#User services|OpenRC]].

== 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
* busybox 1.37.0
* Deno 2.3.1
* dovecot 2.4
* GCC 14.2.0
* GNOME 48
* Go 1.24
* ISC BIND 9.20
* KDE Plasma 6.3
* Linux 6.12
* LLVM 20
* LXQt 2.2.0
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP 8.4
* Qt 6.8
* Ruby 3.4
* Rust 1.87
* wlroots 0.18
* zigbee2mqtt 2.3.0

=== LLVM ===

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

LLD is now also splitted per version and is available as {{pkg|lld20}} (default for {{pkg|lld}}), {{pkg|lld19}} and {{pkg|lld18}}. ({{MR|81774}})

=== woodpecker ===

The {{pkg|woodpecker|repo=community}} CI/CD package has been upgraded from 2.8.0 to 3.6.0. Between version 2.x -> 3.x several changes were made to Woodpecker's API and configuration.

[https://woodpecker-ci.org/migrations#300 2.x -> 3.x migration information can be found here.]

=== dovecot ===

The dovecot package have been upgraded from 2.3 to 2.4 which introduces breaking changes in the configuration format. See [https://doc.dovecot.org/2.4.1/installation/upgrade/2.3-to-2.4.html dovecot documentation] how to migrate.

== 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 {{pkg|incus}} and {{pkg|incus-feature}} (feature branch).

Take a look at the [https://linuxcontainers.org/incus/docs/main/howto/server_migrate_lxd/ Migration Guide] on how to migrate from LXD to Incus using the {{pkg|incus-conversion}} or {{pkg|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 {{Issue|17114}}.

=== Meilisearch ===

<code>meilisearch</code> in aports has not been maintained for a long time. It's removed from Alpine 3.22.

=== Botan 2 ===

Botan2 has reached End of Life and will not be part of 3.22 release

=== pcc (portable C compiler) ===

Unfortunately, upstream's website [https://marc.info/?l=pcc-list&m=170541815829299&w=2 has been offline since 2023-12-11] and hasn't come back online since. AFAIK, there isn't any good alternative source that we can use. The best one we were able to find is an unofficial [https://repo.or.cz/pcc.git repo.or.cz mirror].

As a consequence, other distros (e.g. [https://src.fedoraproject.org/rpms/pcc/c/6e04a3afcbdca49cb4f117e7febdf5ae67a3bed1?branch=rawhide Fedora]) have orphaned pcc and other distros (e.g. Debian) archive very ancient versions of pcc.

=== ruby-grpc ===

GRPC is a huge mess, and we lack the resources to support all its language bindings.

Due to this, we had to also remove ruby-pg_query and sqlint.

<hr><center>[[Release Notes for Alpine 3.21.0|← Previous page: Release Notes for Alpine 3.21.0]] — [[Draft Release Notes for Alpine 3.23.0|Next page: Draft Release Notes for Alpine 3.23.0 →]]</center>

[[Category:News]]

Release Notes for Alpine 3.23.0

2025-10-18T16:23:22Z

Fossdd:

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|This is a list of upcoming changes for the next release 3.23. The release is still work-in-progress and changes might happen.}}

== 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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement] for more details.

=== {{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 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

=== 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.0/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>

Release Notes for Alpine 3.23.0

2025-10-03T09:01:29Z

Fossdd: /* Note-worthy updates */

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 {{Issue|17294}}.}}

== 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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement] for more details

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

4 gets removed

== 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>

Release Notes for Alpine 3.23.0

2025-10-03T09:00:13Z

Fossdd: /* Significant removals */

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 {{Issue|17294}}.}}

== 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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement] for more details

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

4 gets removed

== 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>

Release Notes for Alpine 3.23.0

2025-10-02T12:01:55Z

Fossdd: /* /usr merge */

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 {{Issue|17294}}.}}

== 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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html official announcement] for more details

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

4 gets removed

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-10-02T12:01:38Z

Fossdd: /* /usr merge */

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 {{Issue|17294}}.}}

== 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 are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-10-01-usr-merge.html|official announcement] for more details

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

4 gets removed

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-26T10:50:50Z

Fossdd: /* ffmpeg 8 */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

4 gets removed

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-26T10:50:41Z

Fossdd: /* Note-worthy updates */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== 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 ===

6 -> 8

6 and 7 are still available as ffmpeg6 and ffmpeg7

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T07:53:28Z

Fossdd: /* GNOME 49 */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== 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}})

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T06:51:42Z

Fossdd: /* Note-worthy updates */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

=== GNOME 49 with gnome-session/gdm 48 ===

- also gdk-pixbuf doesnt uses glycin yet

{{Note|TODO}}

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T06:50:29Z

Fossdd: /* Significant removals */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T06:49:48Z

Fossdd: /* ffmpeg4 */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

== Significant removals ==



=== ffmpeg4 ===

{{Note|TODO}}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T06:49:41Z

Fossdd: /* Significant removals */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

== Significant removals ==



=== ffmpeg4 ===

{{Note|TODO}

=== 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>

Release Notes for Alpine 3.23.0

2025-09-25T06:48:43Z

Fossdd: /* Note-worthy updates */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

== Significant removals ==



=== rssh ===

rssh package has been removed due to the dead upstream.

Release Notes for Alpine 3.23.0

2025-08-29T19:56:50Z

Fossdd: /* Significant changes */

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 {{Issue|17294}}.}}

== 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 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

=== {{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 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.

Release Notes for Alpine 3.23.0

2025-08-27T09:43:55Z

Fossdd: /* Note-worthy updates */

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 {{Issue|17294}}.}}

== 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 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

=== {{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}}

== 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.

Release Notes for Alpine 3.23.0

2025-08-19T20:00:20Z

Fossdd: /* Significant changes */

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 {{Issue|17294}}.}}

== 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 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

=== {{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}}

== 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

== Significant removals ==



=== rssh ===

rssh package has been removed due to the dead upstream.

Release Notes for Alpine 3.23.0

2025-07-29T12:41:31Z

Fossdd: usr merge is more important than linux-stable :p

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 {{Issue|17294}}.}}

== 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 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

=== {{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}}

== 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

== Significant removals ==

Release Notes for Alpine 3.23.0

2025-07-29T12:38:34Z

Fossdd: /* {{Pkg|binutils-gold}} removed */

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 {{Issue|17294}}.}}

== 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

=== {{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.

=== /usr merge ===

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

== Significant changes ==

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

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

=== LLVM metapackage ===

{{Note|TODO}}

== 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

== Significant removals ==

User:Sertonix/Freedom of choice

2025-07-23T07:02:35Z

Fossdd: /* SU */ add run0

This is an overview over the different available programms, etc. that can be selected from when using alpine. It is also intended as a reference what should be documented and what could be supported.

== Bootloaders ==
* See: [[Bootloaders]]
* Also: {{Pkg|systemd-boot}}

== Kernel ==
* See: [[Kernels]]

== Libc ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{Pkg|musl}} || style="background:lime" | Full || Default
|-
| [https://www.gnu.org/software/libc/ glibc] || style="background:red" | None || [[Running glibc programs]]
|-
| without aka static || style="background:orange" | depends on package || Note that this only means no libc at runtime
|}
* See also: [https://gitlab.alpinelinux.org/alpine/tsc/-/issues/17 alpine-glibc]
* See also: [https://wiki.gentoo.org/wiki/Libc Gentoo Wiki]

== Initramfs ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{Pkg|mkinitfs}} || style="background:lime" | Full || Default
|-
| {{Pkg|dracut}} || style="background:lime" | Full ||
|-
| {{Pkg|booster}} || style="background:lime" | Full ||
|-
| [https://github.com/illiliti/tinyramfs tinyramfs] || style="background:red" | None ||
|-
| without || style="background:red" | None || may require [[custom Kernel]], [https://kisslinux.org/install#021 kisslinux without initramfs]
|}
* See also: [[Initramfs init]]
* See also: [https://wiki.gentoo.org/wiki/Initramfs Gentoo Wiki]

== PID 1 ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| busybox init || style="background:lime" | Full || Default
|-
| {{Pkg|dinit}} || style="background:orange" | In testing || Shutdown commands are prefixed with {{ic|dinit-}}. eg {{ic|dinit-reboot}}
|-
| {{Pkg|s6-linux-init}} || style="background:orange" | Works || Requires manually running {{ic|s6-linux-init-maker}}
|-
| {{Pkg|openrc-init}} || style="background:orange" | Manual setup ||
|-
| {{Pkg|dumb-init}} || style="background:silver" | Needs testing || For containers
|-
| runit-init || style="background:silver" | Needs testing || [https://dev.alpinelinux.org/~clandmeter/other/forum.alpinelinux.org/comment/383.html#comment-383 runit-init starting OpenRC]
|-
| {{Pkg|epoch}} || style="background:silver" | Needs testing ||
|-
| systemd || style="background:red" | None || Supported by postmarketOS
|-
| custom || style="background:lime" | Full || For example in docker containers
|}
* See also: [https://wiki.gentoo.org/wiki/Init_system Gentoo Wiki]
* See also: [https://wiki.archlinux.org/title/Init Archwiki]

== Service Manager ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[OpenRC]] || style="background:lime" | Full || Default
|-
| {{Pkg|dinit}} || style="background:orange" | In testing || {{Pkg|dinit-alpine}} includes service files
|-
| {{Pkg|s6-rc}} || style="background:orange" | Works || Not integrated. For containers there is {{Pkg|s6-overlay}}
|-
| {{Pkg|runit}} || style="background:orange" | As OpenRC service ||
|-
| {{Pkg|daemontools}} || style="background:silver" | Needs testing ||
|-
| {{Pkg|daemontools-encore}} || style="background:silver" | Needs testing ||
|-
| {{Pkg|supervisor}} || style="background:silver" | Needs testing ||
|-
| busybox runit || style="background:red" | None || Not enabled in a busybox package
|-
| systemd || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:lime" | Full || Requires to replace {{Pkg|alpine-base}} with custom set of packages (See {{Issue|71686}})
|}
* See also: [https://wiki.gentoo.org/wiki/Init_system Gentoo Wiki]
* See also: [https://wiki.archlinux.org/title/Init Archwiki]

== System Logs ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[Syslog#busybox_syslog|busybox syslog]] || style="background:lime" | Full || Default
|-
| {{Pkg|rsyslog}} || style="background:lime" | Full ||
|-
| {{Pkg|syslog-ng}} || style="background:lime" | Full ||
|-
| {{pkg|socklog}} || style="background:silver" | Needs testing ||
|-
| [https://skarnet.org/software/s6/s6-socklog.html s6-socklog] from {{pkg|s6}} || style="background:silver" | Needs testing ||
|-
| systemd-journald || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:silver" | Needs testing ||
|}
* See also: [[Syslog]]

== [[Device Manager]] ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[mdev]] || style="background:lime" | Full || Default
|-
| [[mdevd]] || style="background:lime" | Full ||
|-
| [[eudev]] || style="background:lime" | Full ||
|-
| vdev || style="background:red" | None ||
|-
| systemd-udev || style="background:red" | None || Supported by postmarketOS
|}

== Power Managment ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[busybox acpid]] || style="background:lime" | Full || Default
|-
| {{Pkg|acpid}} || style="background:lime" | Full ||
|-
| {{Pkg|elogind}} || style="background:silver" | Needs testing ||
|-
| systemd-logind || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:lime" | Full ||
|}
* See also: [https://wiki.archlinux.org/title/Power_management Archwiki]
* See also: [https://wiki.gentoo.org/wiki/Power_management Gentoo Wiki]

== DHCP Client ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[Udhcpc|busybox udhcpc]] || style="background:lime" | Full || Default
|-
| {{Pkg|dhcpcd}} || style="background:lime" | Full ||
|-
| {{Pkg|dhclient}} || style="background:lime" | Full ||
|-
| without aka static || style="background:lime" | Full ||
|}
* See also: [[Configure Networking]]
* See also: [https://wiki.archlinux.org/title/Network_configuration#DHCP Archwiki]
* See also: [https://wiki.gentoo.org/wiki/Resolv.conf Gentoo Wiki - resolv.conf]

== Wi-Fi ==
* See: [[Wi-Fi]]
* Also supported: {{pkg|eiwd}}

== Seat/Session Managnent ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[elogind]] || style="background:lime" | Full ||
|-
| {{Pkg|seatd}} || style="background:lime" | Full || seats only
|-
| {{Pkg|turnstile}} || style="background:silver" | needs testing || session only
|-
| systemd-logind || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:lime" | Full || Not recommended with graphical enviroment
|}
* [https://wiki.gentoo.org/wiki/Seatd Gentoo Wiki - seatd]
* [https://wiki.gentoo.org/wiki/Elogind Gentoo Wiki - elogind]
* [https://wiki.archlinux.org/title/Init#logind ArchWiki - systemd-logind]
* [https://chimera-linux.org/docs/configuration/seat Chimera Linux docs]

== Login ==

{| class="wikitable"
|-
! Name !! Support !! Supports [[PAM]] !! Notes
|-
| busybox login || style="background:lime" | Full || style="background:red" | No || Default
|-
| {{Pkg|greetd}} || style="background:lime" | Full || style="background:lime" | Yes || requires greeter
|-
| {{Pkg|shadow-login}} || style="background:lime" | Full || style="background:lime" | Yes ||
|-
| {{Pkg|util-linux-login}} || style="background:lime" | Full || style="background:lime" | Yes ||
|-
| systemd-logind || style="background:red" | None || style="background:lime" | Yes || Supported by postmarketOS
|-
| without || style="background:lime" | Full || style="background:red" | No ||
|}
* See also: [https://wiki.gentoo.org/wiki/Login Gentoo Wiki]

== Shell Utils ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{Pkg|busybox}} || style="background:lime" | Full || Dependency of {{pkg|alpine-base}}
|-
| {{Pkg|busybox-extras}} || style="background:lime" | Full || Some commands that are missing in the main {{Pkg|busybox}} package
|-
| {{Pkg|util-linux}} || style="background:lime" | Full ||
|-
| [[GNU_core_utilities|coreutils]] || style="background:lime" | Full ||
|-
| {{Pkg|s6-portable-utils}} || style="background:lime" | Full ||
|-
| {{Pkg|s6-linux-utils}} || style="background:lime" | Full ||
|-
| {{Pkg|toybox}} || style="background:silver" | Needs testing ||
|-
| {{Pkg|sbase}} || style="background:silver" | Needs testing ||
|-
| {{Pkg|ubase}} || style="background:silver" | Needs testing ||
|-
| without || style="background:red" | None || A lot of implicit dependency
|}
* See also: [https://wiki.archlinux.org/title/Core_utilities Archwiki]

== Shell ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| busybox ash || style="background:lime" | Full || Default
|-
| {{Pkg|bash}} || style="background:lime" | Full ||
|-
| {{Pkg|dash}} || style="background:lime" | Full || When used as /bin/sh this may cause breakage.
|-
| {{Pkg|yash}} || style="background:lime" | Full ||
|-
| busybox hush || style="background:red" | None ||
|-
| without || style="background:red" | None || sometimes implicit dependency
|}
* See also: [[Change default shell]]
* See proposal: [https://gitlab.alpinelinux.org/alpine/tsc/-/issues/39 replace busybox ash with another /bin/sh]
* See also: [https://wiki.archlinux.org/title/Command-line_shell Archwiki]
* See also: [https://wiki.gentoo.org/wiki/Shell Gentoo Wiki]

== SU ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{ic|su}} from {{Pkg|busybox-suid}} || style="background:lime" | Full || default, can't be removed by default ({{issue|11730}})
|-
| {{ic|su}} from {{Pkg|shadow-login}} || style="background:lime" | Full ||
|-
| {{ic|su}} from {{Pkg|util-linux-login}} || style="background:lime" | Full ||
|-
| {{Pkg|sudo}} || style="background:lime" | Full ||
|-
| {{Pkg|doas}} || style="background:lime" | Full || sudo shim using doas: {{Pkg|doas-sudo-shim}}
|-
| [https://skarnet.org/software/s6/s6-sudo.html s6-sudo] || style="background:silver" | Needs testing ||
|
|-
| run0 || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:lime" | Full ||
|}

== SSL/TLS ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{Pkg|openssl}} || style="background:lime" | Full || Default
|-
| {{Pkg|libressl}} || style="background:silver" | Needs testing ||
|-
| {{Pkg|bearssl}} || style="background:silver" | Needs testing ||
|}
* See also: [https://gitlab.alpinelinux.org/alpine/tsc/-/issues/28 consider LibreSSL as default OpenSSL provider again]
* See also: [https://wiki.archlinux.org/title/Transport_Layer_Security Archwiki]
* See also: [https://github.com/haproxy/wiki/wiki/SSL-Libraries-Support-Status haproxy SSL Libraries Support Status]

== Cron ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| {{Pkg|cronie}} || style="background:lime" | Full ||
|-
| {{Pkg|dcron}} || style="background:lime" | Full ||
|-
| {{Pkg|fcron}} || style="background:lime" | Full ||
|-
| vixie-cron || style="background:red" | None ||
|-
| scron || style="background:red" | None ||
|-
| systemd.timer || style="background:red" | None || Supported by postmarketOS
|-
| without || style="background:lime" | Full || {{Pkg|alpine-baselayout}} includes cron specific directories though
|}
* See also: [https://wiki.archlinux.org/title/Cron Archwiki]
* See also: [https://wiki.gentoo.org/wiki/Cron Gentoo Wiki]

== SSH ==

{| class="wikitable"
|-
! Name !! Support !! Notes
|-
| [[Setting_up_a_SSH_server#OpenSSH|openssh]] || style="background:lime" | Full ||
|-
| [[Setting_up_a_SSH_server#Dropbear|dropbear]] || style="background:lime" | Full || provide {{ic|ssh}} command {{pkg|dropbear-ssh}}
|-
| without || style="background:lime" | Full ||
|}
* See also: [https://wiki.archlinux.org/title/Secure_Shell Archwiki]
* See also: [https://wiki.gentoo.org/wiki/SSH Gentoo Wiki - OpenSSH]
* See also: [https://wiki.gentoo.org/wiki/Dropbear Gentoo Wiki - Dropbear]

== Desktop ==
* See: [[Desktop environments and Window managers]]

== See Also ==
* [[Architecture|Alpine Architecture]]
* [https://gitlab.alpinelinux.org/alpine/tsc/-/issues/55 Future of busybox]

Release Notes for Alpine 3.23.0

2025-07-12T22:02:10Z

Fossdd: /* Significant changes */

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 {{Issue|17294}}.}}

== 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

=== {{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}}

== 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

== Significant removals ==

=== {{Pkg|binutils-gold}} removed ===

{{Note|TODO: not yet in edge}}

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>

Release Notes for Alpine 3.23.0

2025-07-11T13:01:33Z

Fossdd: /* Significant changes */

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 {{Issue|17294}}.}}

== 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

=== {{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 ==

=== LLVM metapackage ===

{{Note|TODO}}

== 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

== Significant removals ==

=== {{Pkg|binutils-gold}} removed ===

{{Note|TODO: not yet in edge}}

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>

Release Notes for Alpine 3.23.0

2025-07-11T13:00:48Z

Fossdd:

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 {{Issue|17294}}.}}

== 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

=== {{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 ==

== 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

== Significant removals ==

=== {{Pkg|binutils-gold}} removed ===

{{Note|TODO: not yet in edge}}

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>