Alpine Linux - User contributions [en]

Release Notes for Alpine 3.23.0

2025-11-26T20:19:18Z

Pabloyoyoista: Update /usr-merge being opt-in and not opt-out

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

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

== Important changes ==

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

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

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

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

=== /usr merge ===

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

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

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

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

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

== Significant changes ==

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

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

=== LLVM metapackage ===

{{Note|TODO}}

=== nftrules ===

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

=== curl HTTP/3 ===

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

== Note-worthy updates ==

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

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

=== GCC 15 ===

=== LLVM 21 ===

=== ifupdown-ng 0.13 ===

{{Note|TODO}}

=== GNOME 49 ===

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

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

=== ffmpeg 8 ===

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

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

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

=== ifstate 2 ===

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

== Significant removals ==



=== More Qt5 removals ===

{{Note|TODO}}

=== ffmpeg4 ===

{{Note|TODO}}

=== LLVM 17 ===

=== rssh ===

rssh package has been removed due to the dead upstream.

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

Release Notes for Alpine 3.23.0

2025-07-25T13:19:14Z

Pabloyoyoista:

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

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

{{Note|We're beginning to work on the roadmap for Alpine Linux v3.23. To view the upcoming changes, see {{Issue|17294}}.}}

== Important changes ==

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

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

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

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

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

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

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

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

=== /usr merge ===

New installations are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [https://alpinelinux.org/posts/2025-09-01-usr-merge.html| official announcement] for more details

== Significant changes ==

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

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

=== LLVM metapackage ===

{{Note|TODO}}

== Note-worthy updates ==

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

* BIRD TODO
* busybox TODO
* Deno TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* nginx TODO
* NodeJS TODO (LTS)
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

== Significant removals ==

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

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

The gold linker got deprecated by upstream on February 2025 and in Alpine v3.23 we removed it from our repositories.

Previously this has been hold because of Go's use of the gold linker for ARM architectures, but these days the default ld linker works as expected.

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

Release Notes for Alpine 3.23.0

2025-07-25T13:18:01Z

Pabloyoyoista: Add information on the /usr merge

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

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

{{Note|We're beginning to work on the roadmap for Alpine Linux v3.23. To view the upcoming changes, see {{Issue|17294}}.}}

== Important changes ==

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

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

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

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

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

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

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

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

=== /usr merge ===

New installations are now /usr-merged, and people are encouraged to merge their systems after upgrade. See the [[official announcement|https://alpinelinux.org/posts/2025-09-01-usr-merge.html]] for more details

== Significant changes ==

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

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

=== LLVM metapackage ===

{{Note|TODO}}

== Note-worthy updates ==

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

* BIRD TODO
* busybox TODO
* Deno TODO
* GCC TODO
* GNOME TODO
* Go TODO
* ISC BIND TODO
* KDE Plasma TODO
* Linux TODO
* LLVM TODO
* LXQt TODO
* nginx TODO
* NodeJS TODO (LTS)
* PHP TODO
* Qt TODO
* Ruby TODO
* Rust TODO
* wlroots TODO
* zigbee2mqtt TODO

== Significant removals ==

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

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

The gold linker got deprecated by upstream on February 2025 and in Alpine v3.23 we removed it from our repositories.

Previously this has been hold because of Go's use of the gold linker for ARM architectures, but these days the default ld linker works as expected.

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

Release Notes for Alpine 3.22.0

2025-05-29T13:04:26Z

Pabloyoyoista: Add a comment about /usr merge

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

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

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

Release Notes for Alpine 3.22.0

2025-05-29T12:51:27Z

Pabloyoyoista: Update GNOME version

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

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

Release Notes for Alpine 3.21.0

2024-12-05T12:15:43Z

Pabloyoyoista: Inform GNOME Software being held back

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

=== OpenSSH service requires restart ===

From the <code>9.8_p1</code> release, and on, of {{pkg|openssh}}, {{pkg|openssh-server}} is split into two binaries (<code>/usr/lib/ssh/sshd-session</code> and <code>/usr/sbin/sshd</code>). Due to this change, it will not be possible to <code>ssh</code> into a system that has upgraded from a release prior to <code>9.8_p1</code> to this release or later, without restarting the <code>sshd</code> service.

We have previously brought attention to this - https://alpinelinux.org/posts/2024-07-02-openssh-upgrade-edge.html

Managing services has always been out-of-scope for {{pkg|apk-tools}}, but this one time we will '''make an exception''' when the following conditions are met:
# You have both the {{pkg|openssh-server}} and {{pkg|openssh-server-common-openrc}} packages installed at a version lower than <code>9.8_p1</code>
# The <code>sshd</code> service is started

We will then, post {{pkg|openssh-server}} upgrade, have a <code>post-upgrade</code> script that will:
# Print a message on what is about to happen and why
# Restart the <code>sshd</code> service
# If the command to restart the service fails for any reason, a warning message will be printed and an error code returned to <code>apk</code>, to be noticed by the end of the package upgrades (this will not interrupt the upgrade process).

We have decided to do this in order to help keep you from getting locked out of your system(s) and be able to fix any issues with the upgrade.

See also:
* https://bugzilla.mindrot.org/show_bug.cgi?id=3706
* https://git.alpinelinux.org/aports/commit/?id=6adff08ae09961d4eea66b55a8cca14d3941fb53

=== New loongarch64 architecture ===

Alpine 3.21 is the first release which is available for <code>loongarch64</code>.

Thanks to the support of the team of Loongson dedicated to supporting Alpine Linux and many other contributors.

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

Plans for /usr-merge are underway and we should be able to finalize it in Alpine Linux, version 3.22.

Much preparation has gone into this release to ensure that the merge happens as smoothly as possible. That included moving the location of some binaries and many libraries from <code>/bin</code>, <code>/sbin</code>, and <code>/lib</code> to their counterparts in <code>/usr</code>. As part of the merge, <code>/usr</code> will be mounted from the initramfs to make sure everybody has all necessary binaries in place.

'''Users with installations where <code>/</code> and <code>/usr</code> are on separate filesystems (partitions, volumes, disk drives or other) should proceed with care and report any issues.''' They should also ensure that an entry <code>/usr</code> is added to <code>/etc/fstab</code> before upgrading, and all modules required to mount <code>/usr</code> from the initramfs are added to mkinitfs configuration. New/fresh installations of v3.21 will work out of the box without modification. Please note that <code>/</code> on separate filesystem than <code>/usr</code> is not officially supported.

If you have one of these setups, and have doubts about the configuration, you can open an [https://gitlab.alpinelinux.org/alpine/aports/-/issues/new issue] and ping <code>@pabloyoyoista</code>. We will also publish a blog post soon with further information on the timeline and progress of the merge, as well as how the changes may affect users.

== Significant changes ==

=== Jellyfin ===

Jellyfin now uses the recommended fork of ffmpeg called {{pkg|jellyfin-ffmpeg}} by default. If you want to change the default, take a look at the <code>ffmpegpath</code> variable in <code>/etc/conf.d/jellyfin</code>. ({{MR|69924}})

Jellyfin was disabled for ARM architectures (<code>aarch64</code> and <code>armv7</code>) and is only available for <code>x86_64</code>. ({{Issue|16613}})

=== Bats ===

<code>main/bats</code> was renamed to <code>main/bats-core</code>. There is now a meta package <code>community/bats</code> which contains:

* {{pkg|bats-core}}
* {{pkg|bats-file}}
* {{pkg|bats-support}}
* {{pkg|bats-assert}}

=== Xen 4.19 ===

''qemu-traditional'' and ''stubdom'' are removed from the build in this release, see https://git.alpinelinux.org/aports/commit/?id=24217a24da3924039b000eb17c04bf3f01bf1f12

There is still the {{pkg|xen-qemu}} package, but the regular {{pkg|qemu}} aport [https://git.alpinelinux.org/aports/commit/?id=a9249e2e0de827e88d84c01f9731aeebd248be13 is now built with Xen support], so a {{pkg|qemu-system-*}} package can be used instead.

You can choose to use it in your ''xl.cfg(1)'' like so:
<pre>
device_model_override = "/usr/bin/qemu-system-x86_64"
device_model_version = "qemu-xen"
</pre>

=== uutils-coreutils ===

{{pkg|uutils-coreutils}} is repackaged as a sub-package to {{pkg|uutils}} in such a way as to be a drop-in replacement for GNU {{pkg|coreutils}}.

If you have both {{pkg|uutils-coreutils}} and {{pkg|coreutils}} installed, the latter will be '''purged''' and its symlinks replaced with ones pointing to the <code>/usr/bin/uutils</code> binary. The <code>/usr/bin/uutils-*</code> symlinks, previously provided by {{pkg|uutils-coreutils}}, no longer exist.

If you prefer to use GNU {{pkg|coreutils}}, remove the {{pkg|uutils-coreutils}} package before upgrading, and then add the {{pkg|uutils}} package, containing the <code>/usr/bin/uutils</code> binary.

A few parts of the {{pkg|uutils}} aport are also split into {{pkg|uutils-*}} subpackages, to avoid conflicts or other issues.

=== linux-firmware ===

{{pkg|linux-firmware}} is now compressed with ZSTD compression. If you run a custom built Linux kernel, you need to ensure that <code>CONFIG_FW_LOADER_COMPRESS_ZSTD=y</code> is set in your configuration.

== Note-worthy updates ==

As always, a lot of packages were upgraded. Make sure to read the indivdual release notes of the projects you use.

* Linux 6.12
* busybox 1.37
* GCC 14.2
* LLVM 19
* Go 1.23
* Rust 1.83
* PHP 8.4
* GNOME 47
* KDE Plasma 6.2
* LXQt 2.1
* Qt 6.8
* wlroots 18

=== GCC 14 ===

The Gnu Compiler Collection was upgraded to 14.2.0 and as a result, all packages built with {{pkg|gcc}} in Alpine 3.21 are compiled with GCC 14.2.0.

Make sure to read all changes: https://gcc.gnu.org/gcc-14/changes.html

=== LXQt 2.1 ===

LXQt has been updated to release 2.1.0
* It now uses Qt6
* Many parts of LXQt are now Wayland ready¹, but Wayland ports of the following are pending: {{pkg|screengrab}}, {{pkg|lxqt-globalkeys}}, and keyboard indicator, some input settings, as well as settings for monitor, power button, and screen locker.
* LXQt Panel has a new default application menu called Fancy Menu.
¹ [https://github.com/lxqt/lxqt-wayland-session lxqt-wayland-session] has not been packaged yet, but most folks wanting to test on Wayland will want to use it.

=== Linux 6.12 ===

Alpine 3.21.0 ships Linux 6.12.1 in the {{pkg|linux-lts}} package.

=== PostgreSQL 17 ===

This release features {{pkg|postgresql17}}. We dropped support for {{pkg|postgresql14}}, and moved {{pkg|postgreSQL15}} from main to community.

=== LLVM 19 ===

We packaged LLVM 19 in our repositories. A total of 5 LLVM versions are supported: {{pkg|llvm19}}, {{pkg|llvm18}}, {{pkg|llvm17}}, {{pkg|llvm16}}, {{pkg|llvm15}}.

=== GNOME 47 ===

{{pkg|gnome-software}} has been held back to version 45, after several regressions in the apk plugin on update. See {{issue|16663}} for more details.

== Significant removals ==

=== Disabled packages due to FTBS ===

The following packages are temporarily disabled because they failed to build. We will try to restore them as soon as possible.

* {{pkg|hplip}} ({{Issue|16685}})
* {{pkg|imageflow}} ({{Issue|16679}})
* {{pkg|kdevelop}} ({{MR|75839}})
* {{pkg|postgresql-citus}} ({{Issue|16580}})
* {{pkg|uvicorn}} ({{Issue|16646}})
* {{pkg|vulkan-validation-layers}} ({{Issue|16686}})

=== ISC DHCP ===

If you are still running an ISC DHCP server, you are advised to migrate to a maintained alternative '''before''' upgrading to the 3.21 release.

ISC DHCP has been EoL since 2022. They have a guide for migrating to {{pkg|kea}} here: https://www.isc.org/dhcp_migration/

Up to, and including, the 3.20 version of Alpine, the {{pkg|dhcp|branch=v3.20}} aport has the subpackage {{pkg|keama|branch=v3.20}} that is a tool for helping with migration from ISC DHCP configuration to ISC Kea configuration.

Alternative DHCP servers packaged in Alpine include:
* {{pkg|kea}}
* {{pkg|freeradius-dhcp}}
* {{pkg|dnsmasq}}
* udhcpd - packaged in {{pkg|busybox-extras}}

=== Gogs ===

<code>gogs</code> was removed due to multiple high-severity vulnerabilities for which issues have remained open for a year. The developers of Gogs were contacted multiple times by the Forgejo team but unfortunately received no response. Therefore we have removed Gogs from our repositories. ({{MR|75304}})

Please consider migrating to {{pkg|forgejo|branch=edge|arch=}} or {{pkg|gitea|branch=edge|arch=}}. Both forks are available in our community repo.

The Gitea fork of Gogs was created in 2016 by contributors who were frustrated with the single-maintainer management model of Gogs. Forgejo is a fork of Gitea which was created as a result of the for-profit company Gitea Ltd taking over maintainership (see also https://forgejo.org/compare-to-gitea/).

=== neofetch ===

The upstream repository was archived in April and became unmaintained, therefore we have removed it from our repositories. {{pkg|fastfetch}} provides similar functionality.

Release Notes for Alpine 3.21.0

2024-12-05T08:19:47Z

Pabloyoyoista: Tweak wording on /usr merge installations

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

=== OpenSSH service requires restart ===

From the <code>9.8_p1</code> release, and on, of {{pkg|openssh}}, {{pkg|openssh-server}} is split into two binaries (<code>/usr/lib/ssh/sshd-session</code> and <code>/usr/sbin/sshd</code>). Due to this change, it will not be possible to <code>ssh</code> into a system that has upgraded from a release prior to <code>9.8_p1</code> to this release or later, without restarting the <code>sshd</code> service.

We have previously brought attention to this - https://alpinelinux.org/posts/2024-07-02-openssh-upgrade-edge.html

Managing services has always been out-of-scope for {{pkg|apk-tools}}, but this one time we will '''make an exception''' when the following conditions are met:
# You have both the {{pkg|openssh-server}} and {{pkg|openssh-server-common-openrc}} packages installed at a version lower than <code>9.8_p1</code>
# The <code>sshd</code> service is started

We will then, post {{pkg|openssh-server}} upgrade, have a <code>post-upgrade</code> script that will:
# Print a message on what is about to happen and why
# Restart the <code>sshd</code> service
# If the command to restart the service fails for any reason, a warning message will be printed and an error code returned to <code>apk</code>, to be noticed by the end of the package upgrades (this will not interrupt the upgrade process).

We have decided to do this in order to help keep you from getting locked out of your system(s) and be able to fix any issues with the upgrade.

See also:
* https://bugzilla.mindrot.org/show_bug.cgi?id=3706
* https://git.alpinelinux.org/aports/commit/?id=6adff08ae09961d4eea66b55a8cca14d3941fb53

=== New loongarch64 architecture ===

Alpine 3.21 is the first release which is available for <code>loongarch64</code>.

Thanks to the support of the team of Loongson dedicated to supporting Alpine Linux and many other contributors.

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

Plans for /usr-merge are underway and we should be able to finalize it in Alpine Linux, version 3.22.

Much preparation has gone into this release to ensure that the merge happens as smoothly as possible. That included moving the location of some binaries and many libraries from <code>/bin</code>, <code>/sbin</code>, and <code>/lib</code> to their counterparts in <code>/usr</code>. As part of the merge, <code>/usr</code> will be mounted from the initramfs to make sure everybody has all necessary binaries in place.

'''Users with installations where <code>/</code> and <code>/usr</code> are on separate filesystems (partitions, volumes, disk drives or other) should proceed with care and report any issues.''' They should also ensure that an entry <code>/usr</code> is added to <code>/etc/fstab</code> before upgrading, and all modules required to mount <code>/usr</code> from the initramfs are added to mkinitfs configuration. New/fresh installations of v3.21 will work out of the box without modification.

If you have one of these setups, and have doubts about the configuration, you can open an [https://gitlab.alpinelinux.org/alpine/aports/-/issues/new issue] and ping <code>@pabloyoyoista</code>. We will also publish a blog post soon with further information on the timeline and progress of the merge, as well as how the changes may affect users.

== Significant changes ==

=== Jellyfin ===

Jellyfin now uses the recommended fork of ffmpeg called {{pkg|jellyfin-ffmpeg}} by default. If you want to change the default, take a look at the <code>ffmpegpath</code> variable in <code>/etc/conf.d/jellyfin</code>. ({{MR|69924}})

Jellyfin was disabled for ARM architectures (<code>aarch64</code> and <code>armv7</code>) and is only available for <code>x86_64</code>. ({{Issue|16613}})

=== Bats ===

<code>main/bats</code> was renamed to <code>main/bats-core</code>. There is now a meta package <code>community/bats</code> which contains:

* {{pkg|bats-core}}
* {{pkg|bats-file}}
* {{pkg|bats-support}}
* {{pkg|bats-assert}}

=== Xen 4.19 ===

''qemu-traditional'' and ''stubdom'' are removed from the build in this release, see https://git.alpinelinux.org/aports/commit/?id=24217a24da3924039b000eb17c04bf3f01bf1f12

There is still the {{pkg|xen-qemu}} package, but the regular {{pkg|qemu}} aport [https://git.alpinelinux.org/aports/commit/?id=a9249e2e0de827e88d84c01f9731aeebd248be13 is now built with Xen support], so a {{pkg|qemu-system-*}} package can be used instead.

You can choose to use it in your ''xl.cfg(1)'' like so:
<pre>
device_model_override = "/usr/bin/qemu-system-x86_64"
device_model_version = "qemu-xen"
</pre>

=== uutils-coreutils ===

{{pkg|uutils-coreutils}} is repackaged as a sub-package to {{pkg|uutils}} in such a way as to be a drop-in replacement for GNU {{pkg|coreutils}}.

If you have both {{pkg|uutils-coreutils}} and {{pkg|coreutils}} installed, the latter will be '''purged''' and its symlinks replaced with ones pointing to the <code>/usr/bin/uutils</code> binary. The <code>/usr/bin/uutils-*</code> symlinks, previously provided by {{pkg|uutils-coreutils}}, no longer exist.

If you prefer to use GNU {{pkg|coreutils}}, remove the {{pkg|uutils-coreutils}} package before upgrading, and then add the {{pkg|uutils}} package, containing the <code>/usr/bin/uutils</code> binary.

A few parts of the {{pkg|uutils}} aport are also split into {{pkg|uutils-*}} subpackages, to avoid conflicts or other issues.

=== linux-firmware ===

{{pkg|linux-firmware}} is now compressed with ZSTD compression. If you run a custom built Linux kernel, you need to ensure that <code>CONFIG_FW_LOADER_COMPRESS_ZSTD=y</code> is set in your configuration.

== Note-worthy updates ==

As always, a lot of packages were upgraded. Make sure to read the indivdual release notes of the projects you use.

* Linux 6.12
* busybox 1.37
* GCC 14.2
* LLVM 19
* Go 1.23
* Rust 1.83
* PHP 8.4
* GNOME 47
* KDE Plasma 6.2
* LXQt 2.1
* Qt 6.8
* wlroots 18

=== GCC 14 ===

The Gnu Compiler Collection was upgraded to 14.2.0 and as a result, all packages built with {{pkg|gcc}} in Alpine 3.21 are compiled with GCC 14.2.0.

Make sure to read all changes: https://gcc.gnu.org/gcc-14/changes.html

=== LXQt 2.1 ===

LXQt has been updated to release 2.1.0
* It now uses Qt6
* Many parts of LXQt are now Wayland ready¹, but Wayland ports of the following are pending: {{pkg|screengrab}}, {{pkg|lxqt-globalkeys}}, and keyboard indicator, some input settings, as well as settings for monitor, power button, and screen locker.
* LXQt Panel has a new default application menu called Fancy Menu.
¹ [https://github.com/lxqt/lxqt-wayland-session lxqt-wayland-session] has not been packaged yet, but most folks wanting to test on Wayland will want to use it.

=== Linux 6.12 ===

Alpine 3.21.0 ships Linux 6.12.1 in the {{pkg|linux-lts}} package.

Please note that {{pkg|linux-headers}} is still on 6.6, because the kernel was released after we kicked off our rebuilds and we coudn't ensure that the upgrade doesn't break other packages. (More about the linux-headers 6.12 upgrade: {{MR|75618}})

=== PostgreSQL 17 ===

This release features {{pkg|postgresql17}}. We dropped support for {{pkg|postgresql14}}, and moved {{pkg|postgreSQL15}} from main to community.

=== LLVM 19 ===

We packaged LLVM 19 in our repositories. A total of 5 LLVM versions are supported: {{pkg|llvm19}}, {{pkg|llvm18}}, {{pkg|llvm17}}, {{pkg|llvm16}}, {{pkg|llvm15}}.

== Significant removals ==

=== Disabled packages due to FTBS ===

The following packages are temporarily disabled because they failed to build. We will try to restore them as soon as possible.

* {{pkg|hplip}} ({{Issue|16685}})
* {{pkg|imageflow}} ({{Issue|16679}})
* {{pkg|kdevelop}} ({{MR|75839}})
* {{pkg|postgresql-citus}} ({{Issue|16580}})
* {{pkg|uvicorn}} ({{Issue|16646}})
* {{pkg|vulkan-validation-layers}} ({{Issue|16686}})

=== ISC DHCP ===

If you are still running an ISC DHCP server, you are advised to migrate to a maintained alternative '''before''' upgrading to the 3.21 release.

ISC DHCP has been EoL since 2022. They have a guide for migrating to {{pkg|kea}} here: https://www.isc.org/dhcp_migration/

Up to, and including, the 3.20 version of Alpine, the {{pkg|dhcp|branch=v3.20}} aport has the subpackage {{pkg|keama|branch=v3.20}} that is a tool for helping with migration from ISC DHCP configuration to ISC Kea configuration.

Alternative DHCP servers packaged in Alpine include:
* {{pkg|kea}}
* {{pkg|freeradius-dhcp}}
* {{pkg|dnsmasq}}
* udhcpd - packaged in {{pkg|busybox-extras}}

=== Gogs ===

<code>gogs</code> was removed due to multiple high-severity vulnerabilities for which issues have remained open for a year. The developers of Gogs were contacted multiple times by the Forgejo team but unfortunately received no response. Therefore we have removed Gogs from our repositories. ({{MR|75304}})

Please consider migrating to {{pkg|forgejo|branch=edge|arch=}} or {{pkg|gitea|branch=edge|arch=}}. Both forks are available in our community repo.

The Gitea fork of Gogs was created in 2016 by contributors who were frustrated with the single-maintainer management model of Gogs. Forgejo is a fork of Gitea which was created as a result of the for-profit company Gitea Ltd taking over maintainership (see also https://forgejo.org/compare-to-gitea/).

=== neofetch ===

The upstream repository was archived in April and became unmaintained, therefore we have removed it from our repositories. {{pkg|fastfetch}} provides similar functionality.

Release Notes for Alpine 3.21.0

2024-12-04T16:26:20Z

Pabloyoyoista:

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

=== OpenSSH service requires restart ===

From the <code>9.8_p1</code> release, and on, of {{pkg|openssh}}, {{pkg|openssh-server}} is split into two binaries (<code>/usr/lib/ssh/sshd-session</code> and <code>/usr/sbin/sshd</code>). Due to this change, it will not be possible to <code>ssh</code> into a system that has upgraded from a release prior to <code>9.8_p1</code> to this release or later, without restarting the <code>sshd</code> service.

We have previously brought attention to this - https://alpinelinux.org/posts/2024-07-02-openssh-upgrade-edge.html

Managing services has always been out-of-scope for {{pkg|apk-tools}}, but this one time we will '''make an exception''' when the following conditions are met:
# You have both the {{pkg|openssh-server}} and {{pkg|openssh-server-common-openrc}} packages installed at a version lower than <code>9.8_p1</code>
# The <code>sshd</code> service is started

We will then, post {{pkg|openssh-server}} upgrade, have a <code>post-upgrade</code> script that will:
# Print a message on what is about to happen and why
# Restart the <code>sshd</code> service
# If the command to restart the service would fail, for any reason, a warning message will be printed and an error code returned to <code>apk</code>, to be noticed by the end of the package upgrades (this will not interrupt the upgrade process).

We have decided to do this in order to help keep you from getting locked out of your system(s) and be able to fix any issues with the upgrade.

See also:
* https://bugzilla.mindrot.org/show_bug.cgi?id=3706
* https://git.alpinelinux.org/aports/commit/?id=6adff08ae09961d4eea66b55a8cca14d3941fb53

=== New loongarch64 architecture ===

Alpine 3.21 is the first release which is available for <code>loongarch64</code>.

Thanks to the support of the team of Loongson dedicated to supporting Alpine Linux and many other contributors.

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

We plan for the next Alpine Linux, version 3.22, to contain the /usr-merge.

A lot of preparations went into this release to ensure that the merge happens as smoothly as possible. That included moving the location of some binaries and many libraries from <code>/bin</code>, <code>/sbin</code>, and <code>/lib</code> to their counter-parts in <code>/usr</code>. Users with installations where <code>/</code> and <code>/usr</code> are on separate filesystems (partitions, volumes, disk drives or other) should proceed with care. As part of the merge, <code>/usr</code> will be mounted from the initramfs to make sure everybody has all necessary binaries in place. However, there are currently some bugs being [https://gitlab.alpinelinux.org/alpine/mkinitfs/-/merge_requests/186 worked on]. Until those are worked out and backported, it is advisable to hold the upgrade back. Once it is ready, we will provide more detailed information. If you have one of those setups, and want to help testing, you may open an [https://gitlab.alpinelinux.org/alpine/aports/-/issues/new issue] and ping <code>@pabloyoyoista</code>.

We'll publish soon a blog post with further information, the timeline and the effects.

== Significant changes ==

=== Jellyfin ===

Jellyfin now uses the recommended fork of ffmpeg called {{pkg|jellyfin-ffmpeg}} by default. If you want to change that, take a look at the <code>ffmpegpath</code> variable in <code>/etc/conf.d/jellyfin</code>. ({{MR|69924}})

Jellyfin was disabled for ARM architectures (<code>aarch64</code> and <code>armv7</code>) and is only available for <code>x86_64</code>. ({{Issue|16613}})

=== Bats ===

<code>main/bats</code> was renamed to <code>main/bats-core</code>. Now there is a meta package <code>community/bats</code> which contains:

* {{pkg|bats-core}}
* {{pkg|bats-file}}
* {{pkg|bats-support}}
* {{pkg|bats-assert}}

=== Xen 4.19 ===

''qemu-traditional'' and ''stubdom'' are removed from the build in this release, see https://git.alpinelinux.org/aports/commit/?id=24217a24da3924039b000eb17c04bf3f01bf1f12

There is still the {{pkg|xen-qemu}} package, but the regular {{pkg|qemu}} aport [https://git.alpinelinux.org/aports/commit/?id=a9249e2e0de827e88d84c01f9731aeebd248be13 is now built with Xen support], so a {{pkg|qemu-system-*}} package can be used instead.

You would choose to use it in your ''xl.cfg(1)'' like so:
<pre>
device_model_override = "/usr/bin/qemu-system-x86_64"
device_model_version = "qemu-xen"
</pre>

=== uutils-coreutils ===

{{pkg|uutils-coreutils}} is repackaged as a sub-package to {{pkg|uutils}} in such a way as to be a drop-in replacement for GNU {{pkg|coreutils}}.

If you have both {{pkg|uutils-coreutils}} and {{pkg|coreutils}} installed, the latter will be '''purged''' and its symlinks replaced with ones pointing to the <code>/usr/bin/uutils</code> binary. The <code>/usr/bin/uutils-*</code> symlinks, previously provided by {{pkg|uutils-coreutils}}, no loger exist.

If you prefer to use GNU {{pkg|coreutils}}, you want to remove the {{pkg|uutils-coreutils}} package before upgrading, and then add the {{pkg|uutils}} package, containing the <code>/usr/bin/uutils</code> binary.

A few parts of the {{pkg|uutils}} aport are also split into {{pkg|uutils-*}} subpackages, to avoid conflicts or other issues.

=== linux-firmware ===

{{pkg|linux-firmware}} is now compressed with ZSTD compression. If you run a custom built Linux kernel, you need to ensure that <code>CONFIG_FW_LOADER_COMPRESS_ZSTD=y</code> is set in your configuration.

== Note-worthy updates ==

As always, a lot of packages were upgraded. Make sure to read the indivdual release notes of the projects you use.

* Linux 6.12
* busybox 1.37
* GCC 14.2
* LLVM 19
* Go 1.23
* Rust 1.83
* PHP 8.4
* GNOME 47
* KDE Plasma 6.2
* LXQt 2.1
* Qt 6.8
* wlroots 18

=== GCC 14 ===

The Gnu Compiler Collection was upgraded to 14.2.0 and, as a result, all packages built with {{pkg|gcc}} are in Alpine 3.21 compiled with GCC 14.2.0.

Make sure to read all changes: https://gcc.gnu.org/gcc-14/changes.html

=== LXQt 2.1 ===

LXQt has been updated to release 2.1.0
* It now uses Qt6
* Many parts of LXQt are now wayland ready¹, but wayland ports of the following are pending: {{pkg|screengrab}}, {{pkg|lxqt-globalkeys}}, and keyboard indicator, some input settings, and settings of monitor, power button, and screen locker.
* LXQt Panel has a new default application menu called Fancy Menu.
¹ [https://github.com/lxqt/lxqt-wayland-session lxqt-wayland-session] has not been packaged yet, but most folks wanting to test on wayland will want to use it.

=== Linux 6.12 ===

Alpine 3.21.0 ships Linux 6.12.1 in the {{pkg|linux-lts}} package.

Please note that {{pkg|linux-headers}} still is on 6.6, because the kernel was released after we kicked off our rebuilds and we coudn't ensure that the upgrade doesn't break other packages. (More about the linux-headers 6.12 upgrade: {{MR|75618}})

=== PostgreSQL 17 ===

This release features {{pkg|postgresql17}}. We dropped support for {{pkg|postgresql14}}, and moved {{pkg|postgreSQL15}} from main to community.

=== LLVM 19 ===

We packaged LLVM 19 in our repositories. A total of 5 LLVM versions are supported: {{pkg|llvm19}}, {{pkg|llvm18}}, {{pkg|llvm17}}, {{pkg|llvm16}}, {{pkg|llvm15}}.

== Significant removals ==

=== Disabled packages due to FTBS ===

The following packages are temporarily disabled because they failed to build. We will try to restore them as soon as possible.

* {{pkg|hplip}} ({{Issue|16685}})
* {{pkg|imageflow}} ({{Issue|16679}})
* {{pkg|kdevelop}} ({{MR|75839}})
* {{pkg|postgresql-citus}} ({{Issue|16580}})
* {{pkg|uvicorn}} ({{Issue|16646}})
* {{pkg|vulkan-validation-layers}} ({{Issue|16686}})

=== ISC DHCP ===

{{Note|TODO: Write something ''cool'' if https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/70974 (or alternative) is merged }}

ISC DHCP has been EoL since 2022. They have a guide for migrating to {{pkg|kea}} here: https://www.isc.org/dhcp_migration/

The {{pkg|dhcp}} aport has the subpackage {{pkg|keama}} that is a tool for helping with migration from ISC DHCP configuration to ISC Kea configuration.

=== Gogs ===

<code>gogs</code> was removed due to multiple high-severity vulnerabilities which are open within a year. The developers of Gogs were contacted multiple times by the Forgejo team, but got no response. Therefore we removed Gogs from our repositories. ({{MR|75304}})

Please consider migrating to {{pkg|forgejo|branch=edge|arch=}} or {{pkg|gitea|branch=edge|arch=}}. Both forks are available in our community repo, like gogs was.

The Gitea fork of Gogs was created in 2016 by contributors who were annoyed by the single-maintainer management model of Gogs. Forgejo is a fork of Gitea, which was created because the for-profit company Gitea Ltd took over the maintainership, see also https://forgejo.org/compare-to-gitea/.

=== neofetch ===

The upstream repository was archived in April, therefore is unmaintained and we removed it from our repositories. {{pkg|fastfetch}} provides similar functionality.

Release Notes for Alpine 3.21.0

2024-12-04T16:25:06Z

Pabloyoyoista: Clarify wording on delaying the /usr merge

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

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

== Important changes ==

=== OpenSSH service requires restart ===

From the <code>9.8_p1</code> release, and on, of {{pkg|openssh}}, {{pkg|openssh-server}} is split into two binaries (<code>/usr/lib/ssh/sshd-session</code> and <code>/usr/sbin/sshd</code>). Due to this change, it will not be possible to <code>ssh</code> into a system that has upgraded from a release prior to <code>9.8_p1</code> to this release or later, without restarting the <code>sshd</code> service.

We have previously brought attention to this - https://alpinelinux.org/posts/2024-07-02-openssh-upgrade-edge.html

Managing services has always been out-of-scope for {{pkg|apk-tools}}, but this one time we will '''make an exception''' when the following conditions are met:
# You have both the {{pkg|openssh-server}} and {{pkg|openssh-server-common-openrc}} packages installed at a version lower than <code>9.8_p1</code>
# The <code>sshd</code> service is started

We will then, post {{pkg|openssh-server}} upgrade, have a <code>post-upgrade</code> script that will:
# Print a message on what is about to happen and why
# Restart the <code>sshd</code> service
# If the command to restart the service would fail, for any reason, a warning message will be printed and an error code returned to <code>apk</code>, to be noticed by the end of the package upgrades (this will not interrupt the upgrade process).

We have decided to do this in order to help keep you from getting locked out of your system(s) and be able to fix any issues with the upgrade.

See also:
* https://bugzilla.mindrot.org/show_bug.cgi?id=3706
* https://git.alpinelinux.org/aports/commit/?id=6adff08ae09961d4eea66b55a8cca14d3941fb53

=== New loongarch64 architecture ===

Alpine 3.21 is the first release which is available for <code>loongarch64</code>.

Thanks to the support of the team of Loongson dedicated to supporting Alpine Linux and many other contributors.

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

We plan for the next Alpine Linux, version 3.22, to contain the /usr-merge.

A lot of preparations went into this release to ensure that the merge happens as smoothly as possible. That included moving the location of some binaries and many libraries from <code>/bin</code>, <code>/sbin</code>, and <code>/lib</code> to their counter-parts in <code>/usr</code>. Users with installations where <code>/</code> and <code>/usr</code> are on separate filesystems (partitions, volumes, disk drives or other) should proceed with care. As part of the merge, <code>/usr</code> will be mounted from the initramfs to make sure everybody has all necessary binaries in place. However, there are currently some bugs being [https://gitlab.alpinelinux.org/alpine/mkinitfs/-/merge_requests/186 worked on]. Until those are worked out and backported, it is advisable to hold the upgrade back. If you have one of those setups, and want to help testing, you may open an [https://gitlab.alpinelinux.org/alpine/aports/-/issues/new issue] and ping <code>@pabloyoyoista</code>.

We'll publish soon a blog post with further information, the timeline and the effects.

== Significant changes ==

=== Jellyfin ===

Jellyfin now uses the recommended fork of ffmpeg called {{pkg|jellyfin-ffmpeg}} by default. If you want to change that, take a look at the <code>ffmpegpath</code> variable in <code>/etc/conf.d/jellyfin</code>. ({{MR|69924}})

Jellyfin was disabled for ARM architectures (<code>aarch64</code> and <code>armv7</code>) and is only available for <code>x86_64</code>. ({{Issue|16613}})

=== Bats ===

<code>main/bats</code> was renamed to <code>main/bats-core</code>. Now there is a meta package <code>community/bats</code> which contains:

* {{pkg|bats-core}}
* {{pkg|bats-file}}
* {{pkg|bats-support}}
* {{pkg|bats-assert}}

=== Xen 4.19 ===

''qemu-traditional'' and ''stubdom'' are removed from the build in this release, see https://git.alpinelinux.org/aports/commit/?id=24217a24da3924039b000eb17c04bf3f01bf1f12

There is still the {{pkg|xen-qemu}} package, but the regular {{pkg|qemu}} aport [https://git.alpinelinux.org/aports/commit/?id=a9249e2e0de827e88d84c01f9731aeebd248be13 is now built with Xen support], so a {{pkg|qemu-system-*}} package can be used instead.

You would choose to use it in your ''xl.cfg(1)'' like so:
<pre>
device_model_override = "/usr/bin/qemu-system-x86_64"
device_model_version = "qemu-xen"
</pre>

=== uutils-coreutils ===

{{pkg|uutils-coreutils}} is repackaged as a sub-package to {{pkg|uutils}} in such a way as to be a drop-in replacement for GNU {{pkg|coreutils}}.

If you have both {{pkg|uutils-coreutils}} and {{pkg|coreutils}} installed, the latter will be '''purged''' and its symlinks replaced with ones pointing to the <code>/usr/bin/uutils</code> binary. The <code>/usr/bin/uutils-*</code> symlinks, previously provided by {{pkg|uutils-coreutils}}, no loger exist.

If you prefer to use GNU {{pkg|coreutils}}, you want to remove the {{pkg|uutils-coreutils}} package before upgrading, and then add the {{pkg|uutils}} package, containing the <code>/usr/bin/uutils</code> binary.

A few parts of the {{pkg|uutils}} aport are also split into {{pkg|uutils-*}} subpackages, to avoid conflicts or other issues.

=== linux-firmware ===

{{pkg|linux-firmware}} is now compressed with ZSTD compression. If you run a custom built Linux kernel, you need to ensure that <code>CONFIG_FW_LOADER_COMPRESS_ZSTD=y</code> is set in your configuration.

== Note-worthy updates ==

As always, a lot of packages were upgraded. Make sure to read the indivdual release notes of the projects you use.

* Linux 6.12
* busybox 1.37
* GCC 14.2
* LLVM 19
* Go 1.23
* Rust 1.83
* PHP 8.4
* GNOME 47
* KDE Plasma 6.2
* LXQt 2.1
* Qt 6.8
* wlroots 18

=== GCC 14 ===

The Gnu Compiler Collection was upgraded to 14.2.0 and, as a result, all packages built with {{pkg|gcc}} are in Alpine 3.21 compiled with GCC 14.2.0.

Make sure to read all changes: https://gcc.gnu.org/gcc-14/changes.html

=== LXQt 2.1 ===

LXQt has been updated to release 2.1.0
* It now uses Qt6
* Many parts of LXQt are now wayland ready¹, but wayland ports of the following are pending: {{pkg|screengrab}}, {{pkg|lxqt-globalkeys}}, and keyboard indicator, some input settings, and settings of monitor, power button, and screen locker.
* LXQt Panel has a new default application menu called Fancy Menu.
¹ [https://github.com/lxqt/lxqt-wayland-session lxqt-wayland-session] has not been packaged yet, but most folks wanting to test on wayland will want to use it.

=== Linux 6.12 ===

Alpine 3.21.0 ships Linux 6.12.1 in the {{pkg|linux-lts}} package.

Please note that {{pkg|linux-headers}} still is on 6.6, because the kernel was released after we kicked off our rebuilds and we coudn't ensure that the upgrade doesn't break other packages. (More about the linux-headers 6.12 upgrade: {{MR|75618}})

=== PostgreSQL 17 ===

This release features {{pkg|postgresql17}}. We dropped support for {{pkg|postgresql14}}, and moved {{pkg|postgreSQL15}} from main to community.

=== LLVM 19 ===

We packaged LLVM 19 in our repositories. A total of 5 LLVM versions are supported: {{pkg|llvm19}}, {{pkg|llvm18}}, {{pkg|llvm17}}, {{pkg|llvm16}}, {{pkg|llvm15}}.

== Significant removals ==

=== Disabled packages due to FTBS ===

The following packages are temporarily disabled because they failed to build. We will try to restore them as soon as possible.

* {{pkg|hplip}} ({{Issue|16685}})
* {{pkg|imageflow}} ({{Issue|16679}})
* {{pkg|kdevelop}} ({{MR|75839}})
* {{pkg|postgresql-citus}} ({{Issue|16580}})
* {{pkg|uvicorn}} ({{Issue|16646}})
* {{pkg|vulkan-validation-layers}} ({{Issue|16686}})

=== ISC DHCP ===

{{Note|TODO: Write something ''cool'' if https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/70974 (or alternative) is merged }}

ISC DHCP has been EoL since 2022. They have a guide for migrating to {{pkg|kea}} here: https://www.isc.org/dhcp_migration/

The {{pkg|dhcp}} aport has the subpackage {{pkg|keama}} that is a tool for helping with migration from ISC DHCP configuration to ISC Kea configuration.

=== Gogs ===

<code>gogs</code> was removed due to multiple high-severity vulnerabilities which are open within a year. The developers of Gogs were contacted multiple times by the Forgejo team, but got no response. Therefore we removed Gogs from our repositories. ({{MR|75304}})

Please consider migrating to {{pkg|forgejo|branch=edge|arch=}} or {{pkg|gitea|branch=edge|arch=}}. Both forks are available in our community repo, like gogs was.

The Gitea fork of Gogs was created in 2016 by contributors who were annoyed by the single-maintainer management model of Gogs. Forgejo is a fork of Gitea, which was created because the for-profit company Gitea Ltd took over the maintainership, see also https://forgejo.org/compare-to-gitea/.

=== neofetch ===

The upstream repository was archived in April, therefore is unmaintained and we removed it from our repositories. {{pkg|fastfetch}} provides similar functionality.

Release Notes for Alpine 3.21.0

2024-11-28T10:14:20Z

Pabloyoyoista: Add information on available support for / and /usr in different partitions

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

=== OpenSSH requires restart ===

{{Note|TODO: Remove this section if https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/68589 gets merged before 3.21 is released }}

You need to restart your sshd service!

Since the <code>9.8_p1</code> release, openssh-server is now split into two binaries, sshd and sshd-session. With this change sshd needs to be restarted to be able to accept new connections.

Since managing services has always been out-of-scope for apk, we will NOT do the following for you:

<code>
rc-service --ifstarted sshd restart
</code>

=== New loongarch64 architecture ===

Alpine 3.21 is the first release which is available for <code>loongarch64</code>.

Thanks to the support of the team of Loongson dedicated to supporting Alpine Linux and many other contributors.

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

We plan for the next Alpine Linux, version 3.22, to contain the /usr-merge.

A lot of preparations went into this release to ensure that the merge happens as smoothly as possible. That included moving the location of some binaries and many libraries from <code>/bin</code>, <code>/sbin</code>, and <code>/lib</code> to their counter-parts in <code>/usr</code>. Users with installations where <code>/</code> and <code>/usr</code> are in different partitions should proceed with care, and may be advisable to skip the 3.21 upgrade. If you still want to go ahead, you may open an [https://gitlab.alpinelinux.org/alpine/aports/-/issues/new issue] and ping <code>@pabloyoyoista</code> to ask for support.

{{Note|TODO: replace with actual blog post}}

For more information, the timeline and the effects, read the blog post: https://gitlab.alpinelinux.org/alpine/infra/alpine-mksite/-/merge_requests/88/diffs

== Significant changes ==

=== Jellyfin ===

Jellyfin now uses the recommended fork of ffmpeg called {{pkg|jellyfin-ffmpeg}} by default. If you want to change that, take a look at the <code>ffmpegpath</code> variable in <code>/etc/conf.d/jellyfin</code>. ({{MR|69924}})

Jellyfin was disabled for ARM architectures (<code>aarch64</code> and <code>armv7</code>) and is only available for <code>x86_64</code>. The relevant issue is: {{Issue|16613}}

=== Bats ===

"main/bats" was renamed to "main/bats-core". Now there is a meta package "community/bats" which contains:

* bats-core
* bats-file
* bats-support
* bats-assert

=== Xen ===

qemu-traditional and stubdom are removed from the build in this release, see https://git.alpinelinux.org/aports/commit/?id=24217a24da3924039b000eb17c04bf3f01bf1f12

The regular qemu aport, community/qemu, is now build with xen support, see https://git.alpinelinux.org/aports/commit/?id=a9249e2e0de827e88d84c01f9731aeebd248be13

=== uutils-coreutils ===

"uutils-coreutils" is repackaged as a sub-package to "community/uutils" in such a way as to be a drop-in replacement for GNU coreutils.

If you have both "uutils-coreutils" and "coreutils" installed, the latter will be purged and its symlinks replaced with ones pointing to the /usr/bin/uutils binary, provided by the "uutils" package. If you prefer to use GNU "coreutils", or run into issues with "uutils" as replacement, you may want to remove the "uutils-coreutils" package before upgrading.

A few parts of the uutils are also split into subpackages, to avoid conflicts or other issues.

=== linux-firmware ===

{{pkg|linux-firmware}} is now compressed with ZSTD compression. If you run a custom built Linux kernel, you need to ensure that <code>CONFIG_FW_LOADER_COMPRESS_ZSTD=y</code> is set in your configuration.

== Note-worthy updates ==

As always, a lot of packages were upgraded. Make sure to read the indivdual release notes of the projects you use.

* Linux 6.12
* GCC 14.2.0
* LLVM 19
* Go 1.23.3
* Rust 1.82
* GNOME 47.1
* KDE Plasma 6.2.3
* LXQt 2.1.0
* Qt 6.8.0

=== GCC 14 ===

GCC was upgraded to 14.2.0 and as a result all packages in Alpine 3.21 are compiled with GCC 14.2.0.

Make sure to read all changes: https://gcc.gnu.org/gcc-14/changes.html

=== LXQt 2.1 ===

LXQt has been updated to release 2.1.0
* It now uses Qt6
* Many parts of LXQt are now wayland ready¹, but wayland ports of the following are pending: {{pkg|screengrab}}, {{pkg|lxqt-globalkeys}}, and keyboard indicator, some input settings, and settings of monitor, power button, and screen locker.
* LXQt Panel has a new default application menu called Fancy Menu.
¹ [https://github.com/lxqt/lxqt-wayland-session lxqt-wayland-session] has not been packaged yet, but most folks wanting to test on wayland will want to use it.

=== Linux 6.12 ===

Alpine 3.21.0 ships Linux 6.12.0 in the {{pkg|linux-lts}} package.

Please note that {{pkg|linux-headers}} still is on 6.6, because the kernel was released after we kicked off our rebuilds and we coudn't ensure that the upgrade doesn't break other packages. (More about the linux-headers 6.12 upgrade: {{MR|75618}})

=== PostgreSQL 17 ===

This release features {{pkg|postgresql17}}. We dropped support for {{pkg|postgresql14}}, and moved {{pkg|postgreSQL15}} from main to community.

=== LLVM 19 ===

We packaged LLVM 19 in our repositories. Coming to total of 5 supported LLVM versions: {{pkg|llvm19}}, {{pkg|llvm18}}, {{pkg|llvm17}}, {{pkg|llvm16}}, {{pkg|llvm15}}.

== Significant removals ==

=== Disabled packages due to FTBS ===

{{note|update to latest state (last update 2024-11-28)}}

The following packages are temporarily disabled because they failed to build. We try to restore them as soon as possible.

* {{pkg|guacamole-dotool}} ({{MR|75998}})
* {{pkg|hplip}}
* {{pkg|kdevelop}} ({{MR|75839}})
* {{pkg|postgresql-citus}} ({{MR|75381}}
* {{pkg|uvicorn}} ({{Issue|16646}})
* {{pkg|vulkan-validation-layers}}

=== ISC DHCP ===

{{Note|TODO: Write something cool if https://gitlab.alpinelinux.org/alpine/aports/-/merge_requests/70974 (or alternative) is merged }}

=== Gogs ===

<code>gogs</code> was removed due to multiple high-severity vulnerabilities which are open within a year. The developers of Gogs were contacted multiple times by the Forgejo team, but got no response. Therefore we removed Gogs from our repositories. ({{MR|75304}})

Please consider migrating to {{pkg|forgejo|branch=edge|arch=}} or {{pkg|gitea|branch=edge|arch=}}. Both forks are available in our community repo, like gogs was.

The Gitea fork of Gogs was created in 2016 by contributors who were annoyed by the single-maintainer management model of Gogs. Forgejo is a fork of Gitea, which was created because the for-profit company Gitea Ltd took over the maintainership, see also https://forgejo.org/compare-to-gitea/.

=== neofetch ===

The upstream repository was archived in April, therefore is unmaintained and we removed it from our repositories. {{pkg|fastfetch}} provides similar functionality.

GNOME

2024-06-26T14:19:40Z

Pabloyoyoista: Add instructions on updating GNOME packages

= Prerequisites =

* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]

= Installing packages =

Install basic desktop system and gnome packages.
{{Cmd|# setup-desktop gnome}}

It will take care of installing the basic packages and setting up the display manager.

If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-extra}}

And even all of GNOME games with:
{{Cmd|# apk add gnome-games-collection}}

= Enabling GNOME Shell screen recording =
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}

= Enabling GNOME Software =
For GNOME Software to be able to manage APK packages, it needs the <code>apk-polkit-server</code> service working. To enable it and start it up:
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}

= Updating GNOME packages =

Most GNOME apps and core systems follow a common versioning pattern, and have a similar release cadence. In order to reduce the workload on maintainers, the [https://gitlab.alpinelinux.org/pabloyoyoista/gnome-aports-utils gnome-aports-utils] project exists. It contains a series of scripts that can be used to detect changes on GNOME-related projects, and commit them. When doing major GNOME updates, and doing minor updates on many projects, these scripts can help warranty that no project is forgotten, and reduce the time needed to build and test the upgrades. We recommend everybody to use and contribute to that repository instead of pushing updates for every GNOME component individually.

= Troubleshooting =

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If GNOME Terminal doesn't start, add the following to /etc/profile.d/locale.sh: <code>LANG=en_US.UTF-8</code> and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>

== Slow applications or rendering issues ==

Please note that some applications, i.e. Gnome Web (Epiphany), may require the installation of libraries related to hardware acceleration to work correctly.

In quite some cases, this can be solved by installing <code>mesa-gles</code> (OpenGL ES). Check if you you have issues loading the shared library <code>libGLESv2.so.2</code>. If so, you can install it with:

{{Cmd|# apk add mesa-gles}}

== See also ==
* [https://wiki.archlinux.org/title/GNOME GNOME - Archwiki]
* [https://wiki.gentoo.org/wiki/GNOME GNOME - Gentoo Wiki]
* [https://wiki.postmarketos.org/wiki/GNOME GNOME - PostmarketOS Wiki]

[[Category:Desktop]]
[[Category:Desktop Environments]]

Release Notes for Alpine 3.19.0

2023-12-06T15:48:16Z

Pabloyoyoista: /* Others */ Gnome

== Base System ==

=== iptables-nft ===

The <code>/sbin/iptables{,-save,-restore}</code> symlinks now point to xtables-nft-multi instead of xtables-legacy-multi. This means they use the nftables kernel backend instead of the legacy iptables one.

Since the new iptables- binaries also don't use the iptables backend, to work with any existing rules and save them, you need to install {{pkg|iptables-legacy}} and use <code>iptables-legacy-save</code>.

Because mixing backends is not supported, you should reboot your system if you have to use the iptables commands after upgrading.

=== netns ===

The OpenRC package contains a patch to make it possible to start most services in netns namespaces. See also [[Netns|netns]].

== Others ==

=== HashiCorp packages ===

Due to [https://www.hashicorp.com/blog/hashicorp-adopts-business-source-license the relicensing of HashiCorp software] to [https://spdx.org/licenses/BUSL-1.1.html BUSL-1.1], a non-Open-Source license, the following software have been removed from Alpine:

* Consul
* Nomad
* Packer
* Terraform
* Vault

Our discussion on the topic can be found [https://gitlab.alpinelinux.org/alpine/aports/-/issues/15193 here].

{{pkg|opentofu}}, a fork of Terraform, is available in our testing repository for users of our rolling release, edge.

=== Java 21 ===

The latest LTS java release, openjdk21, is now available in the community repository.

=== KDE ===

KDE Applications have been upgraded from 23.04.x to 23.08.x. KDE Frameworks have been upgraded from 5.105.0 to 5.112.0.
Note that the KDE Frameworks packages have been renamed to add a 5 suffix in preparation for the upcoming KDE 6 release in the next Alpine release. Everything should automatically be upgraded properly but if problems occur make sure to check if the right renamed packages are installed.

=== GNOME ===

GNOME packages have been updated to 45. As part of that release, Cheese has been replaced by Snapshot, and Eye of GNOME by Loupe as the default apps for taking and seeing pictures, respectively. In additions, GNOME Photos was dropped as being mostly unmaintained.

=== Yggdrasil v0.5 ===

{{pkg|yggdrasil}} was upgraded to 0.5.x and the new routing scheme is incompatible with previous versions. "Nodes running this new version '''will not''' be able to peer with earlier versions of Yggdrasil" ([https://github.com/yggdrasil-network/yggdrasil-go/releases/tag/v0.5.0 v0.5.0 release notes], [https://yggdrasil-network.github.io/2023/10/22/upcoming-v05-release.html v0.5 blog post]).

== Upgrades ==

* GCC 13
* LLVM 17
* Kea 2.4
* Xen 4.18
* Git 2.43
* Perl 5.38
* PHP 8.3
* PostgreSQL 16
* SQLite 3.44
* Redis 7.2
* Node.js (lts) 20.10
* Node.js (current) 21.4
* QEMU 8.1
* Ceph 18.2
* GNOME 45
* LXQt 1.4
* wlroots 0.17
* Go 1.21
* Rust 1.72
* Crystal 1.10
* Racket 8.11
* ECL 23.9.9
* Erlang 26
* zlib 1.3
* libsodium 1.0.19
* ICU 74.1
* Protobuf 24.4
* fmt 10
* PipeWire 1.0.0

== Raspberry pi ==

The [https://pkgs.alpinelinux.org/packages?name=linux-rpi&branch=edge linux-rpi] has been simplified. There is now a single kernel flavor for each architecture. This means that the kernels [https://pkgs.alpinelinux.org/packages?name=linux-rpi2&branch=v3.18 linux-rpi2] and [https://pkgs.alpinelinux.org/packages?name=linux-rpi4&branch=v3.18 linux-rpi4] are replaced with [https://pkgs.alpinelinux.org/packages?name=linux-rpi&branch=edge linux-rpi]. The {{Path|config.txt}} is now generated by [https://pkgs.alpinelinux.org/packages?name=raspberrypi-bootloader&branch=edge raspberrypi-bootloader].

[[Category:News]]

GNOME

2023-11-28T21:50:25Z

Pabloyoyoista: /* Slow applications or rendering issues */

= Prerequisites =

* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]

= Installing packages =

Install basic desktop system and gnome packages.
{{Cmd|# setup-desktop gnome}}

It will take care of installing the basic packages and setting up the display manager.

If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-extra}}

And even all of GNOME games with:
{{Cmd|# apk add gnome-games-collection}}

= Enabling GNOME Shell screen recording =
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}

= Enabling GNOME Software =
For GNOME Software to be able to manage APK packages, it needs the <code>apk-polkit-server</code> service working. To enable it and start it up:
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}

= Troubleshooting =

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If GNOME Terminal doesn't start, add the following to /etc/profile.d/locale.sh: <code>LANG=en_US.UTF-8</code> and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>

== Slow applications or rendering issues ==

Please note that some applications, i.e. Gnome Web (Epiphany), may require the installation of libraries related to hardware acceleration to work correctly.

In quite some cases, this can be solved by installing <code>mesa-gles</code> (OpenGL ES). Check if you you have issues loading the shared library <code>libGLESv2.so.2</code>. If so, you can install it with:

{{Cmd|# apk add mesa-gles}}

== See also ==
* [https://wiki.archlinux.org/title/GNOME GNOME - Archwiki]
* [https://wiki.gentoo.org/wiki/GNOME GNOME - Gentoo Wiki]
* [https://wiki.postmarketos.org/wiki/GNOME GNOME - PostmarketOS Wiki]

[[Category:Desktop]]
[[Category:Desktop Environments]]

Release Notes for Alpine 3.18.0

2023-05-09T14:22:40Z

Pabloyoyoista:

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

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-04-20T14:00:41Z

Pabloyoyoista:

* python 3.11 https://docs.python.org/3/whatsnew/3.11.html
* linux-lts 6.1 https://lkml.org/lkml/2022/12/11/206

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

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

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

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

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

GNOME

2023-04-20T13:59:01Z

Pabloyoyoista:

= Prerequisites =

* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] (no longer needed if installing GNOME through "setup-desktop")

{{Note|[[Wayland]] can be used but may be less stable and Gnome may still require Xorg}}

= Installing packages =

Install basic desktop system and gnome packages.
{{Cmd|# setup-desktop gnome}}

It will take care of installing the basic packages and setting up the display manager.

If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-extra}}

And even all of GNOME games with:
{{Cmd|# apk add gnome-games-collection}}

= Enabling terminal apps =
If you want to use the gnome-terminal/other terminal applications you will need to install bash. If you want a typical bash setup also enable bash completion:
{{cmd|# apk add bash}}
{{cmd|# apk add bash-completion}}

= Enabling GNOME Shell screen recording =
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}

= Enabling GNOME Software =
For GNOME Software to be able to manage APK packages, it needs the <code>apk-polkit-server</code> service working. To enable it and start it up:
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}

= Troubleshooting =
If GDM does not start with no logs generated at /var/log/gdm, try setting up udev: {{cmd|# setup-devd udev}}

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If logging in from GDM kicks you back to the login screen, try {{cmd|# apk add bash}} (bug report: #10953 sorry cannot link yet)

If GNOME Terminal doesn't start, add the following to /etc/locale.conf: LANG=en_US.UTF-8 and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>

[[Category:Desktop]]

GNOME

2023-04-20T13:58:23Z

Pabloyoyoista:

= Prerequisites =

* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]] (no longer needed if installing GNOME through "setup-desktop")

{{Note|[[Wayland]] can be used but may be less stable and Gnome may still require Xorg}}

= Installing packages =

Install basic desktop system and gnome packages.
{{Cmd|# setup-desktop gnome}}

It will take care of installing the basic packages and setting up the display manager.

If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-extra}}

And even all of GNOME games with:
{{Cmd|# apk add gnome-games-collection}}

= Enabling terminal apps =
If you want to use the gnome-terminal/other terminal applications you will need to install bash. If you want a typical bash setup also enable bash completion:
{{cmd|# apk add bash}}
{{cmd|# apk add bash-completion}}

= Enabling GNOME Shell screen recording =
For the embedded screen recording in GNOME Shell to work, you will need some additional packages: {{cmd|# apk add pipewire wireplumber gst-plugin-pipewire}}

= Enabling GNOME Software =
For GNOME Software to be able to manage APK packages, it needs the {{apk-polkit-server}} service working. To enable it and start it up:
{{cmd|# rc-update add apk-polkit-server default && rc-service apk-polkit-server start}}

= Troubleshooting =
If GDM does not start with no logs generated at /var/log/gdm, try setting up udev: {{cmd|# setup-devd udev}}

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If logging in from GDM kicks you back to the login screen, try {{cmd|# apk add bash}} (bug report: #10953 sorry cannot link yet)

If GNOME Terminal doesn't start, add the following to /etc/locale.conf: LANG=en_US.UTF-8 and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>

[[Category:Desktop]]

Release Notes for Alpine 3.18.0

2023-02-19T23:13:57Z

Pabloyoyoista:

GNOME

2022-08-01T15:48:48Z

Pabloyoyoista: /* Prerequisites */

GNOME

2022-08-01T15:48:40Z

Pabloyoyoista: /* Prerequisites */

GNOME

2022-08-01T15:48:24Z

Pabloyoyoista: /* Prerequisites */

GNOME

2022-08-01T15:47:24Z

Pabloyoyoista:

GNOME

2022-08-01T15:44:08Z

Pabloyoyoista: /* Installing packages */

= Prerequisites =

* [[Installation|Install]] AlpineLinux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]

{{Note|[[Wayland]] can be used but may be less stable and Gnome may still require Xorg}}

= Installing packages =

Install basic desktop system and gnome packages.
{{Cmd|# setup-desktop gnome}}

It will take care of installing the basic packages and setting up the display manager.

If you want, you can install additional GNOME apps for a more complete GNOME experience with:
{{Cmd|# apk add gnome-apps-extra}}

And even all of GNOME games with:
{{Cmd|# apk add gnome-games-collection}}

= Graphical login =
To start the GDM display manager and login with your user, you need a user other than root for this to succeed. GDM will refuse to start if no user accounts (accounts with a UID >= 1000) are available.
{{Cmd|rc-service gdm start}}

Once you have verified correct operation, you can make GDM start at boot:
{{Cmd|rc-update add gdm}}

= Enabling terminal apps =
If you want to use the gnome-terminal/other terminal applications you will need to install bash. If you want a typical bash setup also enable bash completion:
{{cmd|# apk add bash}}
{{cmd|# apk add bash-completion}}

= Troubleshooting =
If GDM does not start with no logs generated at /var/log/gdm, try installing udev: {{cmd|apk add udev && rc-update add udev}}

If you are unable to log in, check /var/log/gdm/greeter.log, there may be info there from X that indicates failed modules, etc.

If logging in from GDM kicks you back to the login screen, try {{cmd|# apk add bash}} (bug report: #10953 sorry cannot link yet)

If GNOME Terminal doesn't start, add the following to /etc/locale.conf: LANG=en_US.UTF-8 and reboot.

If the on-screen keyboard shows up in GDM after installing other UIs such as Phosh, you need to disable it by opening the Accessibility menu (top right) when you are in the GDM login screen. You can disable the on-screen keyboard there. Or set <code>org.gnome.desktop.a11y.applications screen-keyboard-enabled</code> to <code>false</code> for the <code>gdm</code> user with <code>dconf</code>

[[Category:Desktop]]