Alpine Linux - User contributions [en]

Release Notes for Alpine 3.23.0

2025-12-26T15:31:00Z

Jirutka: /* Note-worthy updates */ Add PostgreSQL 18

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.

=== <code>iwlwifi</code> firmware has moved from {{Pkg|linux-firmware-other}} to {{Pkg|linux-firmware-intel}} ===

This is important for Intel wireless users who have chosen a minimal set of firmware packages, with the {{Pkg|linux-firmware-none}} meta package plus {{Pkg|linux-firmware-other}}, you now need to <code>apk add linux-firmware-intel</code> to get <code>iwlwifi*.ucode.zstd</code> for your device.

== 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* ffmpeg 8
* Garage 2.1.0
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* PostgreSQL 18.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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].

=== PostgreSQL 18 ===

This release features {{pkg|postgresql18}}. We dropped support for {{pkg|postgresql15}}, and moved {{pkg|postgreSQL16}} from main to community.

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

=== postgresql-age ===

Apache AGE [https://github.com/apache/age/issues/2229 lacks behind] in supporting the latest version of PostgreSQL. The project seems to [https://github.com/apache/age/issues/2111#issuecomment-2441903180 lack sufficient manpower]. :(

If you want a graph database on top of PostgreSQL, you can use {{pkg|agensgraph}}. However, unlike AGE, it’s not an extension, but a fork of PostgreSQL.

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

[[Category:News]]

Release Notes for Alpine 3.23.0

2025-12-26T15:28:59Z

Jirutka: /* Note-worthy updates */ Add PostgreSQL 18

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.

=== <code>iwlwifi</code> firmware has moved from {{Pkg|linux-firmware-other}} to {{Pkg|linux-firmware-intel}} ===

This is important for Intel wireless users who have chosen a minimal set of firmware packages, with the {{Pkg|linux-firmware-none}} meta package plus {{Pkg|linux-firmware-other}}, you now need to <code>apk add linux-firmware-intel</code> to get <code>iwlwifi*.ucode.zstd</code> for your device.

== 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* ffmpeg 8
* Garage 2.1.0
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* PostgreSQL 18.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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

=== postgresql-age ===

Apache AGE [https://github.com/apache/age/issues/2229 lacks behind] in supporting the latest version of PostgreSQL. The project seems to [https://github.com/apache/age/issues/2111#issuecomment-2441903180 lack sufficient manpower]. :(

If you want a graph database on top of PostgreSQL, you can use {{pkg|agensgraph}}. However, unlike AGE, it’s not an extension, but a fork of PostgreSQL.

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

[[Category:News]]

Release Notes for Alpine 3.23.0

2025-12-03T17:11:12Z

Jirutka: /* Significant removals */ Add postgresql-age

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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* ffmpeg 8
* Garage 2.1.0
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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

=== postgresql-age ===

Apache AGE [https://github.com/apache/age/issues/2229 lacks behind] in supporting the latest version of PostgreSQL. The project seems to [https://github.com/apache/age/issues/2111#issuecomment-2441903180 lack sufficient manpower]. :(

If you want a graph database on top of PostgreSQL, you can use {{pkg|agensgraph}}. However, unlike AGE, it’s not an extension, but a fork of PostgreSQL.

<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-03T17:06:29Z

Jirutka: /* Significant removals */ Add postgresql-age

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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* ffmpeg 8
* Garage 2.1.0
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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

=== postgresql-age ===

Apache AGE [https://github.com/apache/age/issues/2229 lacks behind] in supporting the latest version of PostgreSQL. The project seems to [https://github.com/apache/age/issues/2111#issuecomment-2441903180 lack sufficient manpower]. :(

<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-03T16:55:00Z

Jirutka: Add Garage 2.1.0

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

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

== 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* ffmpeg 8
* Garage 2.1.0
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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-03T16:52:36Z

Jirutka: Add Valkey 9.0.0

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

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

== 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* Valkey 9.0.0
* 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-03T16:51:55Z

Jirutka: Add OpenSMTPD 7.8.0

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

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

== 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenSMTPD 7.8.0
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* 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-03T16:49:12Z

Jirutka: /* 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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* 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-03T16:49:04Z

Jirutka: nginx --with-compat

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 systemd integration 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 to systemd.

=== curl HTTP/3 ===

{{Pkg|curl}} now got built with HTTP/3 support using nghttp3 and openssl-quic. ({{MR|89382}})

=== nginx --with-compat ===

{{pkg|nginx}} is now compiled with <code>--with-compat</code> (enables dynamic modules compatibility) to make it easier to build third-party nginx modules out-of-tree. There’s also a new subpackage {{pkg|nginx-mod-dev}} which provides the nginx sources and build dependencies needed for building nginx modules.

Please note that using nginx from aports with binary modules built against a different version of nginx or for a different platform (i.e. a different distro or Alpine branch) is '''not supported and will not work correctly'''! The same applies to using nginx modules from aports with a different nginx build.

== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* 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-03T16:23:44Z

Jirutka: Clarify that -systemd subpackages are only for postmarketOS

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 systemd integration 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 to systemd.

=== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* 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-03T16:21:01Z

Jirutka: Add Sway 1.11

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 to systemd.

=== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenZFS 2.4.0-rc4
* PHP 8.5.0
* Qt 6.10
* Ruby 3.4.7
* Rust 1.91.1
* Sway 1.11
* 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-03T16:19:47Z

Jirutka: Remove nginx - no update

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 to systemd.

=== 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
* 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
* NodeJS 24.11.1 (LTS)
* OpenJDK 25
* OpenZFS 2.4.0-rc4
* 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-03T16:19:11Z

Jirutka: Remove Deno - not updated

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 to systemd.

=== 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
* 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
* OpenZFS 2.4.0-rc4
* 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-11-17T11:38:10Z

Jirutka: Add Kea

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
* ISC Kea 3.0.3
* 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.22.0

2025-05-30T11:50:30Z

Jirutka:

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-30T11:49:48Z

Jirutka: Add ruby-grpc to 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 ==

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

The work on /usr-merge has continued since last release. Precaution from [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-30T11:44:20Z

Jirutka: Add pcc to 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 ==

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

The work on /usr-merge has continued since last release. Precaution from [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-30T11:36:28Z

Jirutka: Add Deno 2.3.1

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-30T11:35:21Z

Jirutka: Add zigbee2mqtt

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-30T11:34:08Z

Jirutka: Add nginx built with pcre2

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

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

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

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

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

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

Release Notes for Alpine 3.22.0

2025-05-29T21:31:00Z

Jirutka:

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{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.

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

== 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.TODO
* busybox TODO
* GCC TODO
* GNOME 48
* Go TODO
* ISC BIND 9.20.TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP TODO
* Qt TODO
* Ruby 3.4
* Rust TODO
* wlroots TODO

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

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

Release Notes for Alpine 3.22.0

2025-05-29T21:28:37Z

Jirutka: Add section Secure Boot and Gummiboot

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{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 ===

The {{pkg|secureboot-hook|repo=main}} package, 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.

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

== 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.TODO
* busybox TODO
* GCC TODO
* GNOME 48
* Go TODO
* ISC BIND 9.20.TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP TODO
* Qt TODO
* Ruby 3.4
* Rust TODO
* wlroots TODO

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

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

Release Notes for Alpine 3.22.0

2025-05-29T18:57:39Z

Jirutka:

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{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.

=== gummiboot ===

{{note|TODO: something something https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/84539}}

== 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.TODO
* busybox TODO
* GCC TODO
* GNOME 48
* Go TODO
* ISC BIND 9.20.TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* nginx 1.28
* NodeJS 22.16 (LTS)
* PHP TODO
* Qt TODO
* Ruby 3.4
* Rust TODO
* wlroots TODO

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

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

Release Notes for Alpine 3.22.0

2025-05-29T18:56:41Z

Jirutka: Sort list of note-worthy updated alphabetically

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{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.

=== gummiboot ===

{{note|TODO: something something https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/84539}}

== 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.TODO
* busybox TODO
* GCC TODO
* GNOME 48
* Go TODO
* ISC BIND 9.20.TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* PHP TODO
* Qt TODO
* Ruby 3.4
* Rust TODO
* wlroots TODO

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

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

Release Notes for Alpine 3.22.0

2025-05-29T18:55:39Z

Jirutka: Add Ruby to note-worthy updated

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 [https://wiki.alpinelinux.org/wiki/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, [https://wiki.alpinelinux.org/wiki/Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge upgrade to Alpine edge, enable the testing repository] and install {{pkg|apk-tools3}}.

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

=== KDE Plasma ===

The X11 session for KDE Plasma has been removed. If you had {{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.

=== gummiboot ===

{{note|TODO: something something https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/84539}}

== Note-worthy updates ==

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

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

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

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

UEFI Secure Boot

2025-05-23T22:15:44Z

Jirutka: Replace gummiboot-efistub with systemd-efistub

Refer [[Alpine_and_UEFI|UEFI]] page for info other than Secure boot.
== Mounting ESP ==

Prepare mount point for UEFI partition (ESP) at {{path|/boot/efi}}:

{{cmd|# install -d -m 000 /boot/efi}}

Add the following line to {{path|/etc/fstab}}:

{{Cat|/etc/fstab|...
UUID{{=}}<first-partition-uuid> /boot/efi vfat rw,noatime,fmask{{=}}0022,dmask{{=}}0022,codepage{{=}}437,iocharset{{=}}ascii,shortname{{=}}mixed,utf8,errors{{=}}remount-ro 0 2}}

Mount it:

{{cmd|# mount /boot/efi}}

== Generating own UEFI keys ==

Install package {{pkg|efi-mkkeys}}:

{{cmd|# apk add efi-mkkeys}}

Before creating new keys and modifying EFI variables, it is advisable to backup the current variables, so that they may be restored in case of error:

{{cmd|# mkdir -p /etc/uefi-keys/vendor
# cd /etc/uefi-keys/vendor
# for i in PK KEK db dbx; do efi-readvar -v $i -o $i.esl; done }}

Generate your self-signed PK, KEK and db key, including .esl and .auth files:

{{cmd|# efi-mkkeys -s "Your Name" -o /etc/uefi-keys}}

Now you can uninstall {{pkg|efi-mkkeys}} if you want:

{{cmd|# apk del efi-mkkeys}}

== Generating Unified Kernel Image ==

Install package {{pkg|secureboot-hook}}, {{pkg|systemd-efistub}} (Alpine v3.22+) or {{pkg|gummiboot-efistub}} (prior v3.22), and {{pkg|efibootmgr}}:

{{cmd|# apk add secureboot-hook systemd-efistub efibootmgr}}

{{note|{{pkg|systemd-efistub}} only provides EFI stub binaries, it doesn’t depend on any systemd components. {{pkg|gummiboot-efistub}} doesn’t work anymore.}}

Adjust parameter <code>cmdline</code> in {{path|/etc/kernel-hooks.d/secureboot.conf}}. It should '''not''' contain an <code>initrd=</code> parameter! Example of a valid <code>cmdline</code>:

<pre>cmdline="root=UUID=<uuid-of-your-root-fs> modules=ext4"</pre>

Run kernel hooks:

{{cmd|# apk fix kernel-hooks}}

Disable {{pkg|mkinitfs}} trigger:

{{cmd|# echo 'disable_trigger{{=}}yes' >> /etc/mkinitfs/mkinitfs.conf}}

Add boot entry:

{{cmd|# efibootmgr --disk <dev> --part 1 --create --label 'Alpine Linux' --load /Alpine/linux-lts.efi --verbose}}

Note: This procedure only needs to be done once; after that the Unified Kernel Image will be generated automatically every time the kernel is upgraded.

== Enrolling UEFI keys ==

Copy all *.esl, *.auth files from {{path|/etc/uefi-keys}} to a FAT formatted file system (you can use EFI system partition).

Launch firmware setup utility and enrol db, KEK and PK certificates (in this order!). Firmwares have various different interfaces; the following steps for ThinkPad T14s are just an example.

# Reboot system and enter ThinkPad Setup (F1).
# Go to '''Security''' > '''Secure Boot'''
# Change '''Secure Boot''' to '''Enabled'''
# '''Reset to Setup Mode'''
# Go to '''Key Management'''
# '''Authorized Signature Database (DB)'''
#* '''Enroll DB''' > select your Flash Drive > select '''db.auth'''
#* '''Delete DB''' > delete Microsoft certificates (optional)
# '''Key Exchange Key (KEK)'''
#* '''Enroll KEK''' > select your Flash Drive > select '''KEK.auth'''
#* '''Delete KEK''' > delete Microsoft certificates (optional)
# '''Platform Key (PK)''' > '''Enroll PK''' > select your Flash Drive > select '''PK.auth''' (this MUST be the last!)
# Go to top, '''Restart''' > '''Exit Saving Changes'''

Some devices, such as HP Pavilion laptops, cannot enroll keys through the interface. Instead, you must follow the following steps (steps 1-5 and 9-12 may vary depending on the computer, they are for HP Pavilion laptops as an example):
# Reboot system and enter HP Bios Setup Utility (F10).
# Go to '''System Configuration'''
# Change '''Secure Boot''' to '''Disabled'''
# Select '''Clear All Secure Boot Keys'''
# Press F10 to save settings
# Reboot system and enter Alpine Linux
# Enable the [[Repositories|Community Repository]]
# Run the following commands:
{{cmd|# apk update
# apk add sbctl
# sbctl create-keys
# sbctl sign /boot/efi/Alpine/linux-lts.efi
# sbctl enroll-keys -m }}
# <li value="9"> Reboot system and enter HP Bios Setup Utility (F10).
# Go to '''System Configuration'''
# Change '''Secure Boot''' to '''Enabled'''
# Press F10 to save settings

Note: If you needed to use sbctl, you will have to run <code>sbctl sign /boot/efi/Alpine/linux-lts.efi</code> every time you upgrade the kernel. You should '''not''' need to disable secure boot, so long as you sign the new Unified Kernel Image before you reboot.

== See also ==

* [[Initramfs init]]
* <code>mkinitfs-bootparam(7)</code>

== Resources ==

* [https://wiki.gentoo.org/wiki/User:Sakaki/Sakaki%27s_EFI_Install_Guide/Configuring_Secure_Boot Sakaki's EFI Install Guide/Configuring Secure Boot - Gentoo Wiki]
* [https://wiki.archlinux.org/title/Unified_Extensible_Firmware_Interface/Secure_Boot Unified Extensible Firmware Interface/Secure Boot - ArchWiki]
* [https://github.com/jirutka/efi-mkuki efi-mkuki: EFI Unified Kernel Image Maker] (used by the {{pkg|secureboot-hook}} package)

[[Category:Booting]] [[Category:UEFI]]

Installing Oracle Java

2025-02-18T13:14:49Z

Jirutka: Obsolete and encourages to use unofficial and harmful glibc package

Release Notes for Alpine 3.20.0

2024-05-20T21:43:38Z

Jirutka: Improve formatting

== Base System ==

=== grub 2.12 ===

When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting otherwise your machine might not boot.

The problem is that grub added a new configuration that executes <code>fwsetup --is-supported</code>, but grub 2.06 does not support the <code>--is-supported</code> argument yet, causing grub to try to reboot into firmware unconditionally.

Here is an example assuming the default setup. Don't blindly copy this example, but verify what's applicable to your system.

==== EFI ====

{{Cmd|
# grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}<var>$efi_directory</var> \
--bootloader-id{{=}}alpine --boot-directory{{=}}/boot --no-nvram
# install -D <var>$efi_directory</var>/EFI/alpine/grub<var>$fwa</var>.efi <var>$efi_directory</var>/EFI/boot/boot<var>$fwa</var>.efi

}}

; target : The relevant [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 target] for your system
; efi_directory : Either {{Path|/boot/efi}} or {{Path|/boot}}. Run <code>awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts</code> to confirm.
; fwa : The respective [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 firmware architecture] for your system

==== Short-term workaround ====

A short-term workaround to get the system bootable again is to restore the backup configuration:

{{Cmd|cp /boot/grub/grub.cfg.backup /boot/grub.cfg }}

This should allow you to boot the system again in order to fix it permanently. This will be reverted when either grub or the kernel is updated again.

This will only work if <code>update-grub</code> has not been executed any more since the upgrade to grub 2.12.

== Others ==

=== Redis ===
Due to [https://github.com/redis/redis/pull/13157 the relicensing of Redis] to [https://redis.io/legal/rsalv2-agreement/ RSALv2]+[https://redis.io/legal/server-side-public-license-sspl/ SSPLv1], a non-free license model, the [https://spdx.org/licenses/BSD-3-Clause.html BSD-3-Clause] licensed fork [https://valkey.io/ Valkey] has replaced Redis in the main package repository.

A {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|valkey-compat|branch=v3.20|arch=}}|{{pkg|valkey-compat|branch=edge|arch=}}}} package is provided with symlinks and group for easy Redis replacement.

The {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|redis|branch=v3.20|arch=}}|{{pkg|redis|branch=edge|arch=}}}} aport has been moved to the community repository, with a shorter support cycle, and will not be upgraded past 7.2.x due to the license change.

Another replacement alternative, the [https://spdx.org/licenses/LGPL-3.0-only.html LGPL-3.0-only] licensed fork [https://redict.io/ Redict] is also available in the community repository.

=== yq ===
yq was renamed to yq-go. [https://gitlab.alpinelinux.org/alpine/aports/-/issues/16052 #16052]

=== aws-cli ===
Due to incompatibility issues with Python 3.12, aws-cli has been temporarily disabled until the issue is resolved by upstream. See the corresponding problem upstream: [https://github.com/aws/aws-cli/issues/8342 #8342]

=== GNOME 46 ===

New upstream release of GNOME.

Depending on how you installed GNOME, you may have to manually add <code>gcr-ssh-agent</code> after upgrading to retain GNOME Keyring ssh integration.

== Upgrades ==

* Crystal 1.12
* LLVM 18
* nginx 1.26
* .NET 8
* Nim 2.0
* OpenJDK 22
* Python 3.12
* Racket 8.13
* Ruby 3.3
* Rust 1.7.8
* R 4.4
* Sway 1.9

Release Notes for Alpine 3.20.0

2024-05-20T21:42:09Z

Jirutka: Update Upgrades

== Base System ==

=== grub 2.12 ===

When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting otherwise your machine might not boot.

The problem is that grub added a new configuration that executes <code>fwsetup --is-supported</code>, but grub 2.06 does not support the <code>--is-supported</code> argument yet, causing grub to try to reboot into firmware unconditionally.

Here is an example assuming the default setup. Don't blindly copy this example, but verify what's applicable to your system.

==== EFI ====

{{Cmd|
# grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}<var>$efi_directory</var> \
--bootloader-id{{=}}alpine --boot-directory{{=}}/boot --no-nvram
# install -D <var>$efi_directory</var>/EFI/alpine/grub<var>$fwa</var>.efi <var>$efi_directory</var>/EFI/boot/boot<var>$fwa</var>.efi

}}

; target : The relevant [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 target] for your system
; efi_directory : Either {{Path|/boot/efi}} or {{Path|/boot}}. Run <code>awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts</code> to confirm.
; fwa : The respective [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 firmware architecture] for your system

==== Short-term workaround ====

A short-term workaround to get the system bootable again is to restore the backup configuration:

{{Cmd|cp /boot/grub/grub.cfg.backup /boot/grub.cfg }}

This should allow you to boot the system again in order to fix it permanently. This will be reverted when either grub or the kernel is updated again.

This will only work if <code>update-grub</code> has not been executed any more since the upgrade to grub 2.12.

== Others ==

=== Redis ===
Due to [https://github.com/redis/redis/pull/13157 the relicensing of Redis] to [https://redis.io/legal/rsalv2-agreement/ RSALv2]+[https://redis.io/legal/server-side-public-license-sspl/ SSPLv1], a non-free license model, the [https://spdx.org/licenses/BSD-3-Clause.html BSD-3-Clause] licensed fork [https://valkey.io/ Valkey] has replaced Redis in the main package repository.

A {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|valkey-compat|branch=v3.20|arch=}}|{{pkg|valkey-compat|branch=edge|arch=}}}} package is provided with symlinks and group for easy Redis replacement.

The {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|redis|branch=v3.20|arch=}}|{{pkg|redis|branch=edge|arch=}}}} aport has been moved to the community repository, with a shorter support cycle, and will not be upgraded past 7.2.x due to the license change.

Another replacement alternative, the [https://spdx.org/licenses/LGPL-3.0-only.html LGPL-3.0-only] licensed fork [https://redict.io/ Redict] is also available in the community repository.

=== yq ===
yq was renamed to yq-go. https://gitlab.alpinelinux.org/alpine/aports/-/issues/16052

=== aws-cli ===
Due to incompatibility issues with Python 3.12, aws-cli has been temporarily disabled until the issue is resolved by upstream. See the corresponding problem upstream: https://github.com/aws/aws-cli/issues/8342

=== GNOME 46 ===

New upstream release of GNOME.

Depending on how you installed GNOME, you may have to manually add <code>gcr-ssh-agent</code> after upgrading to retain GNOME Keyring ssh integration.

== Upgrades ==

* Crystal 1.12
* LLVM 18
* nginx 1.26
* .NET 8
* Nim 2.0
* OpenJDK 22
* Python 3.12
* Racket 8.13
* Ruby 3.3
* Rust 1.7.8
* R 4.4
* Sway 1.9

Release Notes for Alpine 3.20.0

2024-05-20T21:41:10Z

Jirutka: Add Upgrades

== Base System ==

=== grub 2.12 ===

When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting otherwise your machine might not boot.

The problem is that grub added a new configuration that executes <code>fwsetup --is-supported</code>, but grub 2.06 does not support the <code>--is-supported</code> argument yet, causing grub to try to reboot into firmware unconditionally.

Here is an example assuming the default setup. Don't blindly copy this example, but verify what's applicable to your system.

==== EFI ====

{{Cmd|
# grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}<var>$efi_directory</var> \
--bootloader-id{{=}}alpine --boot-directory{{=}}/boot --no-nvram
# install -D <var>$efi_directory</var>/EFI/alpine/grub<var>$fwa</var>.efi <var>$efi_directory</var>/EFI/boot/boot<var>$fwa</var>.efi

}}

; target : The relevant [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 target] for your system
; efi_directory : Either {{Path|/boot/efi}} or {{Path|/boot}}. Run <code>awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts</code> to confirm.
; fwa : The respective [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 firmware architecture] for your system

==== Short-term workaround ====

A short-term workaround to get the system bootable again is to restore the backup configuration:

{{Cmd|cp /boot/grub/grub.cfg.backup /boot/grub.cfg }}

This should allow you to boot the system again in order to fix it permanently. This will be reverted when either grub or the kernel is updated again.

This will only work if <code>update-grub</code> has not been executed any more since the upgrade to grub 2.12.

== Others ==

=== Redis ===
Due to [https://github.com/redis/redis/pull/13157 the relicensing of Redis] to [https://redis.io/legal/rsalv2-agreement/ RSALv2]+[https://redis.io/legal/server-side-public-license-sspl/ SSPLv1], a non-free license model, the [https://spdx.org/licenses/BSD-3-Clause.html BSD-3-Clause] licensed fork [https://valkey.io/ Valkey] has replaced Redis in the main package repository.

A {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|valkey-compat|branch=v3.20|arch=}}|{{pkg|valkey-compat|branch=edge|arch=}}}} package is provided with symlinks and group for easy Redis replacement.

The {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|redis|branch=v3.20|arch=}}|{{pkg|redis|branch=edge|arch=}}}} aport has been moved to the community repository, with a shorter support cycle, and will not be upgraded past 7.2.x due to the license change.

Another replacement alternative, the [https://spdx.org/licenses/LGPL-3.0-only.html LGPL-3.0-only] licensed fork [https://redict.io/ Redict] is also available in the community repository.

=== yq ===
yq was renamed to yq-go. https://gitlab.alpinelinux.org/alpine/aports/-/issues/16052

=== aws-cli ===
Due to incompatibility issues with Python 3.12, aws-cli has been temporarily disabled until the issue is resolved by upstream. See the corresponding problem upstream: https://github.com/aws/aws-cli/issues/8342

=== GNOME 46 ===

New upstream release of GNOME.

Depending on how you installed GNOME, you may have to manually add <code>gcr-ssh-agent</code> after upgrading to retain GNOME Keyring ssh integration.

== Upgrades ==

* Crystal 1.12
* LLVM 18
* nginx 1.26
* .NET 8
* Nim 2.0
* OpenJDK 22
* Python 3.12
* Racket 8.13
* Ruby 3.3
* Rust 1.7.8
* R 4.4

Release Notes for Alpine 3.20.0

2024-05-20T21:20:33Z

Jirutka: Fix grammar

== Base System ==

=== grub 2.12 ===

When upgrading existing installations using grub on UEFI systems, make sure to update the installed bootloader before rebooting otherwise your machine might not boot.

The problem is that grub added a new configuration that executes <code>fwsetup --is-supported</code>, but grub 2.06 does not support the <code>--is-supported</code> argument yet, causing grub to try to reboot into firmware unconditionally.

Here is an example assuming the default setup. Don't blindly copy this example, but verify what's applicable to your system.

==== EFI ====

{{Cmd|
# grub-install --target{{=}}<var>$target</var> --efi-directory{{=}}<var>$efi_directory</var> \
--bootloader-id{{=}}alpine --boot-directory{{=}}/boot --no-nvram
# install -D <var>$efi_directory</var>/EFI/alpine/grub<var>$fwa</var>.efi <var>$efi_directory</var>/EFI/boot/boot<var>$fwa</var>.efi

}}

; target : The relevant [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 target] for your system
; efi_directory : Either {{Path|/boot/efi}} or {{Path|/boot}}. Run <code>awk '$2 ~ /boot/ && $3 ~ /fat|msdos/ { print $2 }' /proc/mounts</code> to confirm.
; fwa : The respective [https://gitlab.alpinelinux.org/alpine/alpine-conf/-/blob/master/setup-disk.in#L320-324 firmware architecture] for your system

==== Short-term workaround ====

A short-term workaround to get the system bootable again is to restore the backup configuration:

{{Cmd|cp /boot/grub/grub.cfg.backup /boot/grub.cfg }}

This should allow you to boot the system again in order to fix it permanently. This will be reverted when either grub or the kernel is updated again.

This will only work if <code>update-grub</code> has not been executed any more since the upgrade to grub 2.12.

== Others ==

=== Redis ===
Due to [https://github.com/redis/redis/pull/13157 the relicensing of Redis] to [https://redis.io/legal/rsalv2-agreement/ RSALv2]+[https://redis.io/legal/server-side-public-license-sspl/ SSPLv1], a non-free license model, the [https://spdx.org/licenses/BSD-3-Clause.html BSD-3-Clause] licensed fork [https://valkey.io/ Valkey] has replaced Redis in the main package repository.

A {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|valkey-compat|branch=v3.20|arch=}}|{{pkg|valkey-compat|branch=edge|arch=}}}} package is provided with symlinks and group for easy Redis replacement.

The {{#ifexpr: {{AlpineLatest}} >= 3.20 |{{pkg|redis|branch=v3.20|arch=}}|{{pkg|redis|branch=edge|arch=}}}} aport has been moved to the community repository, with a shorter support cycle, and will not be upgraded past 7.2.x due to the license change.

Another replacement alternative, the [https://spdx.org/licenses/LGPL-3.0-only.html LGPL-3.0-only] licensed fork [https://redict.io/ Redict] is also available in the community repository.

=== yq ===
yq was renamed to yq-go. https://gitlab.alpinelinux.org/alpine/aports/-/issues/16052

=== aws-cli ===
Due to incompatibility issues with Python 3.12, aws-cli has been temporarily disabled until the issue is resolved by upstream. See the corresponding problem upstream: https://github.com/aws/aws-cli/issues/8342

=== GNOME 46 ===

New upstream release of GNOME.

Depending on how you installed GNOME, you may have to manually add <code>gcr-ssh-agent</code> after upgrading to retain GNOME Keyring ssh integration.

UEFI Secure Boot

2023-09-05T23:31:52Z

Jirutka: Add gummiboot-efistub to packages needed to install

== Mounting ESP ==

Prepare mount point for UEFI partition (ESP) at {{path|/boot/efi}}:

{{cmd|# install -d -m 000 /boot/efi}}

Add the following line to {{path|/etc/fstab}}:

{{Cat|/etc/fstab|...
UUID{{=}}<first-partition-uuid> /boot/efi vfat rw,noatime,fmask{{=}}0022,dmask{{=}}0022,codepage{{=}}437,iocharset{{=}}ascii,shortname{{=}}mixed,utf8,errors{{=}}remount-ro 0 2}}

Mount it:

{{cmd|# mount /boot/efi}}

== Generating own UEFI keys ==

Install package {{pkg|efi-mkkeys}}:

{{cmd|# apk add efi-mkkeys}}

Before creating new keys and modifying EFI variables, it is advisable to backup the current variables, so that they may be restored in case of error:

{{cmd|# mkdir -p /etc/uefi-keys/vendor
# cd /etc/uefi-keys/vendor
# for i in PK KEK db dbx; do efi-readvar -v $i -o $i.esl; done }}

Generate your self-signed PK, KEK and db key, including .esl and .auth files:

{{cmd|# efi-mkkeys -s "Your Name" -o /etc/uefi-keys}}

Now you can uninstall {{pkg|efi-mkkeys}} if you want:

{{cmd|# apk del efi-mkkeys}}

== Generating Unified Kernel Image ==

Install package {{pkg|secureboot-hook}}, {{pkg|gummiboot-efistub}}, and {{pkg|efibootmgr}}:

{{cmd|# apk add secureboot-hook gummiboot-efistub efibootmgr}}

Adjust parameter <code>cmdline</code> in {{path|/etc/kernel-hooks.d/secureboot.conf}}. It should '''not''' contain an <code>initrd=</code> parameter! Example of a valid <code>cmdline</code>:

<pre>cmdline="root=UUID=<uuid-of-your-root-fs> modules=ext4"</pre>

Run kernel hooks:

{{cmd|# apk fix kernel-hooks}}

Disable {{pkg|mkinitfs}} trigger:

{{cmd|# echo 'disable_trigger{{=}}yes' >> /etc/mkinitfs/mkinitfs.conf}}

Add boot entry:

{{cmd|# efibootmgr --disk <dev> --part 1 --create --label 'Alpine Linux' --load /Alpine/linux-lts.efi --verbose}}

Note: This procedure only needs to be done once; after that the Unified Kernel Image will be generated automatically every time the kernel is upgraded.

== Enrolling UEFI keys ==

Copy all *.esl, *.auth files from {{path|/etc/uefi-keys}} to a FAT formatted file system (you can use EFI system partition).

Launch firmware setup utility and enrol db, KEK and PK certificates (in this order!). Firmwares have various different interfaces; the following steps for ThinkPad T14s are just an example.

# Reboot system and enter ThinkPad Setup (F1).
# Go to '''Security''' > '''Secure Boot'''
# Change '''Secure Boot''' to '''Enabled'''
# '''Reset to Setup Mode'''
# Go to '''Key Management'''
# '''Authorized Signature Database (DB)'''
#* '''Enroll DB''' > select your Flash Drive > select '''db.auth'''
#* '''Delete DB''' > delete Microsoft certificates (optional)
# '''Key Exchange Key (KEK)'''
#* '''Enroll KEK''' > select your Flash Drive > select '''KEK.auth'''
#* '''Delete KEK''' > delete Microsoft certificates (optional)
# '''Platform Key (PK)''' > '''Enroll PK''' > select your Flash Drive > select '''PK.auth''' (this MUST be the last!)
# Go to top, '''Restart''' > '''Exit Saving Changes'''

Some devices, such as HP Pavilion laptops, cannot enroll keys through the interface. Instead, you must follow the following steps (steps 1-5 and 9-12 may vary depending on the computer, they are for HP Pavilion laptops as an example):
# Reboot system and enter HP Bios Setup Utility (F10).
# Go to '''System Configuration'''
# Change '''Secure Boot''' to '''Disabled'''
# Select '''Clear All Secure Boot Keys'''
# Press F10 to save settings
# Reboot system and enter Alpine Linux
# Enable the [[Repositories|Community Repository]]
# Run the following commands:
{{cmd|# apk update
# apk add sbctl
# sbctl create-keys
# sbctl sign /boot/efi/Alpine/linux-lts.efi
# sbctl enroll-keys -m }}
# <li value="9"> Reboot system and enter HP Bios Setup Utility (F10).
# Go to '''System Configuration'''
# Change '''Secure Boot''' to '''Enabled'''
# Press F10 to save settings

Note: If you needed to use sbctl, you will have to run <code>sbctl sign /boot/efi/Alpine/linux-lts.efi</code> every time you upgrade the kernel. You should '''not''' need to disable secure boot, so long as you sign the new Unified Kernel Image before you reboot.

== Resources ==

* [https://wiki.gentoo.org/wiki/User:Sakaki/Sakaki%27s_EFI_Install_Guide/Configuring_Secure_Boot Sakaki's EFI Install Guide/Configuring Secure Boot - Gentoo Wiki]
* [https://wiki.archlinux.org/title/Unified_Extensible_Firmware_Interface/Secure_Boot Unified Extensible Firmware Interface/Secure Boot - ArchWiki]
* [https://github.com/jirutka/efi-mkuki efi-mkuki: EFI Unified Kernel Image Maker] (used by the {{pkg|secureboot-hook}} package)

[[Category:Booting]]

Repositories

2023-06-17T13:06:30Z

Jirutka: Update section Managing repositories according to https://gitlab.alpinelinux.org/alpine/alpine-conf/-/merge_requests/155

{{TOC right}}

There are three repositories:

* '''main''' packages are the software that have direct support and updates from the Alpine core and main team. They also have official special documentation, are always available for all releases and will have substitutions if some are not continued from upstream. Commonly these packages are selected due to their responsibility and stability with respect to upstream availability. Packages from ''community'' or (rarely) ''testing'', that are accepted go to the ''main'' repository.

* '''community''' packages are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions and could end if the user(s) stops; they may also be removed in a future release due to lack of support by upstream authors. Packages from ''testing'' that are accepted go to the ''community'' repository.

* '''testing''' packages are where new packages go. These are made by any contributor to Alpine. Testing has no release linked. The ''testing'' repository is only available on ''edge''. Packages from ''testing'' that are accepted go to the ''community'' repository or (rarely) the ''main'' repository.

= Managing repositories =

The package repositories that <code>apk</code> uses to retrieve package files for installation are specified in file {{path|/etc/apk/repositories}}. Each line of this file specifies the location of a package repository, and optionally a tag. Lines that start with a hash character (#) are ignored.

The location may be an <code>http://</code> or <code>https://</code> URL, or the path to a directory on the local filesystem. A [[Package_management#Repository_pinning|tagged]] repository is prefixed with the <code>@tag</code> specifier, followed by a space and the repository location.

The default will look something like:

{{cat|/etc/apk/repositories|#/media/cdrom/apks
http://dl-cdn.alpinelinux.org/alpine/v3.16/main
http://dl-cdn.alpinelinux.org/alpine/v3.16/community}}

After making changes to {{path|/etc/apk/repositories}} you should update the package index using:
{{cmd|# apk update}}

=== Changing repositories to https ===
For better security you should probably change the url's from '''http''' to '''https'''. [https://en.wikipedia.org/wiki/HTTPS#Technical]

{{Note|Some Alpine Linux package mirrors may not support '''https'''. If that is the case, you will need to change mirrors or revert back. You can check if your mirror supports '''https''' on https://mirrors.alpinelinux.org }}

=== Avoid manually changing the repositories file for a new release ===

You can avoid having to manually update the version in <code>/etc/apk/repositories</code> for each Alpine Linux release by changing <code>v3.16</code> to <code>latest-stable</code>.

Example:
{{cat|/etc/apk/repositories|#/media/cdrom/apks
https://dl-cdn.alpinelinux.org/alpine/latest-stable/main
https://dl-cdn.alpinelinux.org/alpine/latest-stable/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
#http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

{{Warning|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades.}}

= Release Branches =

There are several release branches for Alpine Linux available at the same time. Each May and November we make a release branch from '''edge'''. The '''main''' repository is typically supported for 2 years and the '''community''' repository is supported until next stable release.

Security fixes beyond that can be made on request when there are patches available.

== Main ==

''main'' has a support cycle of 2 years. We also try to limit the amount of packages in ''main'' to only include base system packages, in base you can think of packages which are needed by other packages or are needed to setup a basic system. Packages in ''main'' must '''not''' have dependencies in other repositories.

== Community ==

The '''community''' repository was introduced with Alpine Linux version [https://alpinelinux.org/posts/Alpine-3.3.0-released.html 3.3.0]. ''community'' has a maximum support cycle of 6 months. After that you will need to update to the new release to continue to have support.

= Edge =

''edge'' is the name given to the current [[Aports tree|development tree]] of Alpine Linux. It consists of an APK repository called ''edge'' and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis.

{{Warning|''edge'' is under constant development so be careful using it in production. It is possible that bugs in ''edge'' could cause data loss or could break your system.}}

End users should not use ''edge'' as their main day-to-day workstation or as a productive system. Because ''edge'' is a development branch, many changes are not heavily tested (or tested at all) and packages in ''edge'' can and sometimes do break without warning.

However, testing ''edge'' is a very valuable activity which helps the Alpine Linux development to ensure that the quality of the stable releases is high. Testing ''edge'' is a great way to contribute to the Alpine Linux development.

== Upgrading to edge ==

{{:Include:Upgrading to Edge}}

== Testing ==

The '''testing''' repository was introduced with Alpine Linux ''edge'' development. No support (staging only) and only built for ''edge''. If it stays here long enough it gets moved to unmaintained/purged (gets cleaned up every 6 months).

Before a package can move from ''testing'' to ''main'' or ''community'', the following requirements must be met:

# Package must work correctly, including the init.d script (if provided) and default configuration.
# Packaging must be done correctly, with files installed in the right places, e.g. configs are in <code>/etc/</code> and not in <code>/usr/etc</code>.
# Package dependencies are handled correctly. Abuild can (and should) autodetect shared libs, for example '''sqlite-libs''' provides '''so:libsqlite3.so.0'''. Any package linked to '''sqlite''' should have an automatically (by abuild) added <code>depend=so:libsqlite3.so.0</code> and the user should not have to manually add a <code>depend="sqlite-libs"</code> in the APKBUILD.
# There is a maintainer who claims responsibility for the maintenance of the package and can help fix things if they break in the future.

=== Using the testing repository on stable branches ===

{{Warning|'''Only do this if you're 100% sure what you're doing!''' Installing packages from edge that link to something in ''main'' or ''community'' usually will not work. Alpine does not officially support mixing branches this way.}}

Edit the file <code>/etc/apk/repositories</code> and add (or uncomment) a line that points to the "testing" directory, while also [[Package_management#Repository_pinning|tagging]] the repository, for example:

{{Cat|/etc/apk/repositories|
https://dl-cdn.alpinelinux.org/alpine/v3.16/main
https://dl-cdn.alpinelinux.org/alpine/v3.16/community
@testing https://dl-cdn.alpinelinux.org/alpine/edge/testing
}}

In that case, the tag is <code>@testing</code>, which allows you to pull packages from that repository without potentially messing up your install (too badly):

$ apk add wireguard-go@testing

= See also =

* [[Alpine Linux in a chroot]]
* [http://bugs.alpinelinux.org/ Report Bugs]

[[Category:Development]]
[[Category:Package Manager]]

Repositories

2023-06-17T12:44:22Z

Jirutka: Community repository is enabled by default now

{{TOC right}}

There are three repositories:

* '''main''' packages are the software that have direct support and updates from the Alpine core and main team. They also have official special documentation, are always available for all releases and will have substitutions if some are not continued from upstream. Commonly these packages are selected due to their responsibility and stability with respect to upstream availability. Packages from ''community'' or (rarely) ''testing'', that are accepted go to the ''main'' repository.

* '''community''' packages are those made by users in team with the official developers and close to the Alpine package process. They are supported by those user(s) contributions and could end if the user(s) stops; they may also be removed in a future release due to lack of support by upstream authors. Packages from ''testing'' that are accepted go to the ''community'' repository.

* '''testing''' packages are where new packages go. These are made by any contributor to Alpine. Testing has no release linked. The ''testing'' repository is only available on ''edge''. Packages from ''testing'' that are accepted go to the ''community'' repository or (rarely) the ''main'' repository.

= Managing repositories =

To enable a repository, remove the '''#''' in front of the URL along with any blank space.

Example: Disabled
{{cat|/etc/apk/repositories|#http://dl-cdn.alpinelinux.org/alpine/v3.16/community}}

Example: Enabled
{{cat|/etc/apk/repositories|http://dl-cdn.alpinelinux.org/alpine/v3.16/community}}

To edit the repositories, open the <code>/etc/apk/repositories</code> file in a text editor:

{{cmd|# <editor> /etc/apk/repositories}}

The default will look something like:

{{cat|/etc/apk/repositories|#/media/cdrom/apks
http://dl-cdn.alpinelinux.org/alpine/v3.16/main
#http://dl-cdn.alpinelinux.org/alpine/v3.16/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
#http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

After making changes to <code>/etc/apk/repositories</code> you should update the package index using:
{{cmd|# apk update}}

=== Changing repositories to https ===
For better security you should probably change the url's from '''http''' to '''https'''. [https://en.wikipedia.org/wiki/HTTPS#Technical]

{{Note|Some Alpine Linux package mirrors may not support '''https'''. If that is the case, you will need to change mirrors or revert back. You can check if your mirror supports '''https''' on https://mirrors.alpinelinux.org }}

=== Avoid manually changing the repositories file for a new release ===

You can avoid having to manually update the version in <code>/etc/apk/repositories</code> for each Alpine Linux release by changing <code>v3.16</code> to <code>latest-stable</code>.

Example:
{{cat|/etc/apk/repositories|#/media/cdrom/apks
https://dl-cdn.alpinelinux.org/alpine/latest-stable/main
https://dl-cdn.alpinelinux.org/alpine/latest-stable/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
#http://dl-cdn.alpinelinux.org/alpine/edge/testing}}

{{Warning|Changing the repositories to <code>latest-stable</code> may initiate unexpected release upgrades.}}

= Release Branches =

There are several release branches for Alpine Linux available at the same time. Each May and November we make a release branch from '''edge'''. The '''main''' repository is typically supported for 2 years and the '''community''' repository is supported until next stable release.

Security fixes beyond that can be made on request when there are patches available.

== Main ==

''main'' has a support cycle of 2 years. We also try to limit the amount of packages in ''main'' to only include base system packages, in base you can think of packages which are needed by other packages or are needed to setup a basic system. Packages in ''main'' must '''not''' have dependencies in other repositories.

== Community ==

The '''community''' repository was introduced with Alpine Linux version [https://alpinelinux.org/posts/Alpine-3.3.0-released.html 3.3.0]. ''community'' has a maximum support cycle of 6 months. After that you will need to update to the new release to continue to have support.

= Edge =

''edge'' is the name given to the current [[Aports tree|development tree]] of Alpine Linux. It consists of an APK repository called ''edge'' and contains the latest build of all available Alpine Linux packages. Those packages are updated on a regular basis.

{{Warning|''edge'' is under constant development so be careful using it in production. It is possible that bugs in ''edge'' could cause data loss or could break your system.}}

End users should not use ''edge'' as their main day-to-day workstation or as a productive system. Because ''edge'' is a development branch, many changes are not heavily tested (or tested at all) and packages in ''edge'' can and sometimes do break without warning.

However, testing ''edge'' is a very valuable activity which helps the Alpine Linux development to ensure that the quality of the stable releases is high. Testing ''edge'' is a great way to contribute to the Alpine Linux development.

== Upgrading to edge ==

{{:Include:Upgrading to Edge}}

== Testing ==

The '''testing''' repository was introduced with Alpine Linux ''edge'' development. No support (staging only) and only built for ''edge''. If it stays here long enough it gets moved to unmaintained/purged (gets cleaned up every 6 months).

Before a package can move from ''testing'' to ''main'' or ''community'', the following requirements must be met:

# Package must work correctly, including the init.d script (if provided) and default configuration.
# Packaging must be done correctly, with files installed in the right places, e.g. configs are in <code>/etc/</code> and not in <code>/usr/etc</code>.
# Package dependencies are handled correctly. Abuild can (and should) autodetect shared libs, for example '''sqlite-libs''' provides '''so:libsqlite3.so.0'''. Any package linked to '''sqlite''' should have an automatically (by abuild) added <code>depend=so:libsqlite3.so.0</code> and the user should not have to manually add a <code>depend="sqlite-libs"</code> in the APKBUILD.
# There is a maintainer who claims responsibility for the maintenance of the package and can help fix things if they break in the future.

=== Using the testing repository on stable branches ===

{{Warning|'''Only do this if you're 100% sure what you're doing!''' Installing packages from edge that link to something in ''main'' or ''community'' usually will not work. Alpine does not officially support mixing branches this way.}}

Edit the file <code>/etc/apk/repositories</code> and add (or uncomment) a line that points to the "testing" directory, while also [[Package_management#Repository_pinning|tagging]] the repository, for example:

{{Cat|/etc/apk/repositories|
https://dl-cdn.alpinelinux.org/alpine/v3.16/main
https://dl-cdn.alpinelinux.org/alpine/v3.16/community
@testing https://dl-cdn.alpinelinux.org/alpine/edge/testing
}}

In that case, the tag is <code>@testing</code>, which allows you to pull packages from that repository without potentially messing up your install (too badly):

$ apk add wireguard-go@testing

= See also =

* [[Alpine Linux in a chroot]]
* [http://bugs.alpinelinux.org/ Report Bugs]

[[Category:Development]]
[[Category:Package Manager]]

Release Notes for Alpine 3.18.0

2023-05-09T14:43:43Z

Jirutka: Don't promise akms signing for v3.18, just in case

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

''Note: {{pkg|akms}} (Alpine Kernel Module Support) doesn't support modules signing yet, it will be implemented later.''

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. [https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300 release notes]

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated from 4.2 to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

On related news, to make use of GNOME Software, it is necessary to enable the <code>apk-polkit-server</code> openrc service. More info in the [https://wiki.alpinelinux.org/wiki/Gnome#Enabling_GNOME_Software wiki]

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== QEMU 8 ===

QEMU was updated from 7.1 to 8.0. [https://www.qemu.org/2023/04/20/qemu-8-0-0/ release notes]

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:58:06Z

Jirutka: Add note about akms

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

''Note: {{pkg|akms}} (Alpine Kernel Module Support) doesn't support modules signing yet, it will be implemented later and backported to v3.18.''

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. [https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300 release notes]

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated from 4.2 to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== QEMU 8 ===

QEMU was updated from 7.1 to 8.0. [https://www.qemu.org/2023/04/20/qemu-8-0-0/ release notes]

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:07:34Z

Jirutka: Add QEMU

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. [https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300 release notes]

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated from 4.2 to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== QEMU 8 ===

QEMU was updated from 7.1 to 8.0. [https://www.qemu.org/2023/04/20/qemu-8-0-0/ release notes]

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:05:59Z

Jirutka: Add old version to R

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. [https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300 release notes]

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated from 4.2 to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:05:34Z

Jirutka: Formatting

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. [https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300 release notes]

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:04:03Z

Jirutka: Add old version to python

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated from 3.10 to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:03:38Z

Jirutka: Add old version to ruby

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated from 3.1 to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T11:03:19Z

Jirutka: Add old version to rust

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated from 1.64 to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T10:55:51Z

Jirutka: Add Sway

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== Sway 1.8 ===

{{pkg|sway}} was updated from 1.7 to 1.8. [https://github.com/swaywm/sway/releases/tag/1.8 release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T10:54:48Z

Jirutka: Add crystal

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== Crystal 1.8 ===

{{pkg|crystal}} was updated from 1.6 to 1.8. [https://crystal-lang.org/2023/01/09/1.7.0-released/ release notes for 1.7], [https://crystal-lang.org/2023/04/14/1.8.0-released/ release notes for 1.8]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T10:44:35Z

Jirutka: Split to categories

== Base System ==

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

== Compilers and Runtimes ==

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== Lua ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

==== splitting of python pycache .pyc files ====

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== Ruby 3.2 ===

{{pkg|ruby}} was updated to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated to 1.69.

== Desktop ==

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

== Others ==

=== Removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

Release Notes for Alpine 3.18.0

2023-05-09T10:33:11Z

Jirutka: Improve formatting and grammar

=== Linux Kernel ===

{{pkg|linux-lts}} was updated from 5.15 to 6.1. [https://lkml.org/lkml/2022/12/11/206 release notes]

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP. [https://www.openwall.com/lists/musl/2023/05/02/1 release notes]

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== GNOME ===

The {{pkg|gnome}} metapackage was reworked and the packages {{pkg|gnome-apps-extra}} and {{pkg|gnome-games-collection}} were removed to avoid opinionated lists in metapackages. It is advised to remove those from <code>/etc/apk/world</code> before performing the upgrade. Additionally, the new subpackage {{pkg|gnome-dev-tools}} was added following the upstream's recommendations.

=== Plasma 5.27.4 ===

{{pkg|plasma}} was updated from 5.26.5 to 5.27.4. This includes some new packages like {{pkg|plasma-welcome}} (a welcoming application that shows up on the first boot to configure some initial settings) and {{pkg|flatpak-kcm}} (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be built on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== dbus ===

dbus-activation has been removed from packages {{pkg|openrc-settingsd}} and {{pkg|apk-polkit-rs}}. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== removal of pipewire-media-session ===

{{pkg|pipewire-media-session}} was removed, as upstream explicitly recommends not to use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have {{pkg|pipewire-media-session}} in <code>/etc/apk/world</code>, and configure any scripts you might've had to launch <code>wireplumber</code> instead.

=== Python ===

{{pkg|python3}} was updated to 3.11. [https://docs.python.org/3/whatsnew/3.11.html release notes]

=== splitting of python pycache .pyc files ===

Most python modules split their <code>__pycache__</code> to a <code>-pyc</code> subpackage, pulled by default. To save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== PHP 8.2 ===

Added 8.2 packages with a subset of the most common extensions. Version 8.1 still remains the primary provider priority, but some web applications started to use 8.2.

=== Ruby 3.2 ===

{{pkg|ruby}} was updated to 3.2. [https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/ release notes]

=== gdk-pixbuf-loaders ===

A few gdk-pixbuf loaders were added, and they were all added to an <code>install_if</code> metapackage rule. Run <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for the corresponding image libraries you have installed.

=== Docker 23 ===

The {{pkg|docker}} package shipped with Alpine 3.18 has a dependency on {{pkg|docker-cli-buildx}}, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to the [https://docs.docker.com/engine/release-notes/23.0/ release notes].

=== e2fsprogs 1.47.0 ===

The {{pkg|e2fsprogs}} package shipped with Alpine 3.18 changed the behaviour of <code>mke2fs</code> so that newly created filesystems have two additional features enabled.

From [https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0 release notes]:

<blockquote>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</blockquote>

However, whilst the <code>metadata_csum_seed</code> feature is known about by older versions of e2fsck the <code>orphan_file</code> feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

=== nginx 1.24 ===

{{pkg|nginx}} was updated to the new stable branch 1.24.x. [https://nginx.org/en/CHANGES-1.24 release notes]

=== Rust 1.69 ===

{{pkg|rust}} was updated to 1.69.

=== R 4.3 ===

{{pkg|R}} was updated to 4.3. [https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/ release notes]

=== LLVM 16 ===

{{pkg|llvm16}} was added. [https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html release notes]

=== LuaRocks 3 ===

{{pkg|luarocks}}, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

Release Notes for Alpine 3.18.0

2023-05-09T10:15:22Z

Jirutka: Add LuaRocks

=== Linux Kernel ===

linux-lts 6.1 https://lkml.org/lkml/2022/12/11/206

Kernel modules are now signed.

=== musl 1.2.4 ===

Support for DNS lookups over TCP.

https://www.openwall.com/lists/musl/2023/05/02/1

=== DT_RELR ===

on x86, x86_64, and ppc64le, <code>-Wl,-z,pack-relative-relocs</code> is now added to the base LDFLAGS. this reduces elf (executable/shared-library) size by 10% on average.

however, these binaries are now not portable to other musl-based systems that have a musl older than 1.2.4, because older versions are incapable of loading these binaries.

=== GNOME ===

The gnome metapackage was reworked and the packages gnome-apps-extra and gnome-games-collection were removed to avoid opinionated lists in metapackages. It is advised to remove those from /etc/apk/world before performing the upgrade. Additionally, the new subpackage gnome-dev-tools was added following upstream's recommendations.

=== Plasma 5.27.4 ===

From 5.26.5 before. This includes some new packages like plasma-welcome (a welcoming application that shows up on first boot to configure some initial settings) and flatpak-kcm (a configuration page for the system settings to control Flatpak permissions, much like GNOME's Flatseal).
This Plasma release is the last one that will be build on Qt5 and will probably remain in use for Alpine 3.19 as well.

=== dbus ===

dbus-activation has been removed from packages <code>openrc-settingsd</code> and <code>apk-polkit-rs</code>. To make use of their services, make sure to start and enable the <code>openrc-settingsd</code> and <code>apk-polkit-server</code> services, respectively.

=== removal of pipewire-media-session ===

pipewire-media-session was removed, as upstream explicitly recommends to not use it, and it's completely superceded by wireplumber.
if you used it, make sure you don't have pipewire-media-session in /etc/apk/world, and configure any scripts you might've had to launch wireplumber instead.

=== Python ===

python 3.11 https://docs.python.org/3/whatsnew/3.11.html

=== splitting of python pycache .pyc files ===

most python modules split their __pycache__ to a -pyc subpackage, pulled by default. to save space and not pull it (incurring python interpreter startup costs, as it generates it each run), run <code>apk add !python3-pyc</code>

=== PHP 8.2 ===

Added 8.2 packages with subset of the most common extensions. Version 8.1 still remains primary provider priority but some web applications started to use 8.2.

=== Ruby 3.2 ===

Ruby was updated to 3.2. https://www.ruby-lang.org/en/news/2022/12/25/ruby-3-2-0-released/

=== gdk-pixbuf-loaders ===

a few gdk-pixbuf loaders were added, and they were all added to an install_if metapackage rule- <code>apk add gdk-pixbuf-loaders</code> to enable the loaders for corresponding image libraries you have installed.

=== Docker 23 ===

The <code>docker</code> package shipped with Alpine 3.18 has a dependency on <code>docker-cli-buildx</code>, as Docker 23 now uses it for builds.

Also, Docker 23 no longer enables the <code>overlay</code> storage driver, as it has been deprecated for a long time and is nearing removal. if your deployment is still configured to use it, <code>dockerd</code> will fail to start. To fix this, either...

* migrate to <code>overlay2</code> in <code>/etc/docker/daemon.json</code>
* hardcode it to <code>overlay</code> in the same file (instead of blank), though this will eventually break in a future upgrade

For more detailed information about Docker 23, please refer to https://docs.docker.com/engine/release-notes/23.0/

=== e2fsprogs 1.47.0 ===

The <code>e2fsprogs</code> package shipped with Alpine 3.18 changed the behaviour of mke2fs so that newly created filesystems have two additional features enabled.

From https://e2fsprogs.sourceforge.net/e2fsprogs-release.html#1.47.0

<code>The mke2fs program (via the mke2fs.conf file) now enables the metadata_csum_seed and orphan_file features by default.</code>

However whilst the metadata_csum_seed feature is known about by older versions of e2fsck the orphan_file feature was both added to e2fsprogs 1.47.0 '''and''' enabled at the same time. Therefore older versions of e2fsck are unable to fsck a filesystem created by mke2fs 1.47.0.

=== nginx 1.24 ===

nginx was updated to the new stable branch 1.24.x. https://nginx.org/en/CHANGES-1.24

=== Rust 1.69 ===

rust was updated to 1.69.

=== R 4.3 ===

R was updated to 4.3. https://www.r-bloggers.com/2023/04/whats-new-in-r-4-3-0/

=== LLVM 16 ===

LLVM 16 was added. https://releases.llvm.org/16.0.0/docs/ReleaseNotes.html

=== LuaRocks 3 ===

LuaRocks, the package manager for Lua, was updated from 2.x to 3x. https://github.com/luarocks/luarocks/blob/master/CHANGELOG.md#whats-new-in-luarocks-300

Release Notes for Alpine 3.18.0

2023-05-09T10:11:02Z

Jirutka: Add LLVM

Release Notes for Alpine 3.18.0

2023-05-09T10:08:54Z

Jirutka: Add R

Release Notes for Alpine 3.18.0

2023-05-09T10:07:29Z

Jirutka: Add rust