Breaking Changes

In case of outdated systemd-sysupdate transfer files

1. Download or clone our repo.

2. Navigate to the correct path:

   cd AstrOS/system/mkosi.images/base/mkosi.extra/usr/lib/

3. Update from the newest transfer files:

   sudo systemd-sysupdate update --definitions=sysupdate.d/

Upgrading from 20260721000055 or earlier

Action required before you reboot

Applies to every system updating from build 20260721000055 or earlier.

If you boot the new image without completing those steps, the new image will start without your user account and will re-run first-boot setup. Nothing is lost permanently as the account is still present after a rollback.

1. Persist /etc before updating

Copy the current /etc into the mutable extensions directory and drop the symlinks that point back into the factory tree:

sudo mkdir -p /var/lib/extensions.mutable
sudo cp --archive --no-target-directory /etc /var/lib/extensions.mutable/etc
sudo find /var/lib/extensions.mutable/etc -lname '*share/factory*' -delete

2. Update and reboot

updatectl update
sudo systemctl reboot

Log in to confirm your user account is intact before continuing.

3. Remove the stale /etc

The old /etc is still on disk and could cause problems in the future.

• Roll back to build 20260721000055 or earlier.
• Confirm which build you booted:

   cat /etc/os-release

Do not continue unless this reports 20260721000055 or older.

• Delete the stale configuration:

   sudo rm -rf /etc/*

• Reboot back into the new image.