Alpine Linux 3.23.0 — What’s New and How to Get Started

Alpine Linux 3.23.0 — What’s New and How to Get Started

Table of contents:-

What’s New in Alpine 3.23.0

Fresh Install, Upgrade Paths and Desktop Setup

What These Changes Mean in Practice

Conclusion

The latest stable release of Alpine Linux — version 3.23.0, announced on 3 December 2025 — brings a major evolution in package management, a shift in kernel packaging, and paves the way for future improvements. Here’s a detailed, friendly, and practical look at what’s new, how to upgrade or install, and what to expect.

What’s New in Alpine 3.23.0

Alpine 3.23.0 is the first release in the v3.23 stable series — and it packs a few important changes. The headline feature is the long-awaited upgrade of the internal package manager. The new version of the package tool, apk-tools v3, is now considered stable and ready for general use. For most users, the transition from the previous v2 should be seamless. However, there can be breaking changes if you rely on the lower-level library interface libapk. Crucially though, while the package manager has moved forward, Alpine for now continues to use the existing v2 index and package format — the shift to a v3 index/format will come in a later release.

Another notable structural change concerns the kernel package naming: the previously used package linux-edge has been replaced by a new package called linux-stable. Under the hood, linux-stable shares the same configuration as the long-term support (LTS) kernel package (often named linux-lts), but now tracks the stable release branch. For systems that previously had linux-edge installed, the package manager will automatically replace it with linux-stable.

One change that had been expected for 3.23 — the long-planned merge of /usr (i.e. making /usr and / unified rather than separate) — has been postponed due to technical challenges. A new timeline for the /usr merge will be published later. For now, the old filesystem layout remains.

Beyond these major items, numerous packages and components have been updated — reflecting the usual semi-annual refresh of software that Alpine is known for.

Fresh Install, Upgrade Paths and Desktop Setup

Upgrading from 3.22 → 3.23

Upgrading from 3.22 to 3.23 in a standard “sys mode” installation is fairly straightforward:

1. Update your /etc/apk/repositories file so that the version number in mirror URLs changes from v3.22 to v3.23. This can be done manually, via a script (for example setup-apkrepos), 

or with a one-liner such as:

sed -i -e 's/v3\.22/v3\.23/g' /etc/apk/repositories

2. Once updated, refresh package lists with
   apk update

3. Optionally upgrade apk-tools itself first (though not strictly necessary), then upgrade all installed packages:

apk add --upgrade apk-tools  apk upgrade --available

The --available flag ensures that all packages are re-evaluated, even if the version number hasn’t changed — sometimes necessary when foundational libraries (e.g., musl) are updated.

4. After upgrading, you should reboot if the kernel was upgraded. Also restart any services that have been updated.

It’s wise to back up important data before upgrading — especially if you have unusual partitioning (e.g. separate /usr) — and to review the release notes.

Installing Alpine 3.23 Anew

If you’re doing a fresh install of 3.23, you start by downloading one of the official 3.23 images (Standard, Extended, Virtual, etc.) from the Alpine website. Pick the image that fits your architecture — e.g. x86_64 for most desktops and servers — and verify the download (via sha-256 and GPG signature) to ensure integrity.

Boot into the live environment, then run the convenient installation script:

setup-alpine

You may choose “quick” mode if you just want a minimal, working system rapidly, or run full mode to answer all prompts (keyboard layout, network, hostname, repositories etc.). For typical installations on a single disk with DHCP networking, the defaults are usually fine.

If you want more control — custom partitioning, UEFI bootloader, special filesystem choices — you can skip or partially use setup-alpine and instead perform a semi-automatic or manual install using the steps documented in the official handbook (setup-disk, parted, etc.).

Once installation is complete and system is rebooted, you’ll want to follow post-install recommendations: create a regular user (rather than using root day-to-day), set up a package cache, enable useful services like networking, SSH or NTP, depending on use.

Adding a Desktop Environment

If your intention is to run Alpine as a desktop (rather than a minimal server), the distribution supports desktop environments. After installation, you can install a DE using the built-in helper:

setup-desktop

This utility will present options (GNOME, KDE Plasma, Xfce, MATE, etc.), install the selected desktop environment, and configure it to start on boot. After reboot and login with a non-root user, you should arrive at your graphical desktop.

If you prefer manual control (for example, lighter window managers, or custom setups), you can simply use apk add to install the relevant packages — because package management under apk remains consistent and powerful.

What These Changes Mean in Practice

With apk-tools v3 now stable, Alpine users gain a modernised package manager: faster, more robust, and ready for future-index format improvements. The change from linux-edge → linux-stable helps clarify kernel packaging and ensures use of a stable, maintained kernel rather than a rolling-edge one.

The postponement of the /usr merge signals caution and attention to stability — a reminder that Alpine balances minimalism and security with practical reliability. For anyone setting up new machines or upgrading, this release continues Alpine’s reputation as a lean, efficient, and up-to-date Linux distribution.

If you combine Alpine 3.23 with a desktop environment, you’ll get a surprisingly full-featured system — ideal for developers, privacy-conscious users, or anyone who wants a clean, minimal but capable Linux desktop or server.

Conclusion

Alpine Linux 3.23.0 is a carefully considered evolution of the distribution: bringing a modernised package manager, revisiting kernel packaging semantics, and laying groundwork for future structural changes — all while maintaining the lightweight, security-aware philosophy Alpine is known for. Whether upgrading an existing install or starting afresh, the process remains fairly smooth, especially if you follow the official handbook. For those who prefer a minimalist server or those eager to run a full desktop under Alpine, this release delivers a solid foundation.

As always, trade names like “Linux” or “apk” are acknowledged as belonging to their respective copyright holders. We strive for accuracy in reporting and encourage readers to test and use open-source software responsibly and legally.

References:

• Alpine Linux 3.23.0 Released

• Upgrading Alpine Linux to a new release branch

• setup-alpine

• Post Installation Recommendations - Alpine Linux Documentation

---

🏞️

Back to top