Skip to content

Migrate Older Installations

2024-12-01 image or earlier

To update a system installed from this or an earlier image, run the following in a terminal window:

git clone https://invent.kde.org/kde-linux/kde-linux
cd kde-linux
git checkout 1906f71
run0 ./update.sh update

2025-08-04 image or earlier

To adopt the erofs-based /usr on a system installed from the 2025-08-04 image or earlier, first update to the 2025-08-05 image or later, then create a file named /etc/sysupdate.d/erofs.feature.d/enable.conf containing the following:

[Feature]
Enabled=true

And then run:

run0 /usr/lib/systemd/systemd-sysupdate update

After a reboot, /usr will be a read-only erofs volume, and the rest of / will be writable by the root user.

See Overview of RootFS v2 for an overview of this change, and manual migration instructions should the automatic migration fail.

2026-10-25 image or earlier

To update from images that pre-date the migration of the update server infrastructure, the delta update service needs to be disabled.

To temporarily disable delta updates, run:

systemctl stop kde-linux-sysupdated.socket

(Supply your password when prompted, to authorize the operation.)

Then run:

updatectl vacuum && updatectl update

On rebooting into the updated system, updates should work correctly again. In Discover, you may see a temporary “Protocol Error” status for system updates: if so, click Refresh and the error should clear.


Article contributed by , and under the CC-BY-4.0 license.