atomic-desktops/docs
10
4
Fork 12
Code Issues 10 Pull requests 2 Activity

Merge pull request 'updates-upgrades-rollbacks: Clarify options for each variant' (#19) from siosm/atomic-desktops-docs:main-updates into main

Browse source 
Reviewed-on: #19
Reviewed-by: Hristo Marinov <hricky@noreply.forge.fedoraproject.org>
This commit is contained in:
Hristo Marinov 2026-03-15 13:35:32 +00:00
commit a446461b58
1 changed files with 30 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

40
modules/ROOT/pages/updates-upgrades-rollbacks.adoc
View file

@ -8,16 +8,21 @@ Additionally, you can choose to have multiple versions of your operating system
[[updating]]
== Updating Fedora Atomic Desktops
OS updates are fully integrated into the desktop; you will be automatically notified when an update is available.
On Silverblue and Kinoite, updates are automatically downloaded.
On Atomic Desktops, you can keep using your computer while applying OS updates as they are downloaded and installed in the background.
Once an update has been installed, you can reboot your computer to start using the new version.
You will not have to wait for the update to be installed either during shutdown or boot up.
On Fedora Silverblue and Fedora Kinoite, OS updates are downloaded automatically and you will be notified when updates are ready to be applied via a reboot.
This behavior can be changed in the settings.
On Sway Atomic, Budgie Atomic and COSMIC Atomic, updates need to be manually applied.
Once an update is ready, it is just a matter of rebooting to start using the new version.
There is no waiting for the update to be installed during this reboot.
On Fedora Budgie Atomic, you can update the OS manually using Plasma Discover.
If you'd prefer, it is also possible to update using the command line.
To do this, run:
On Fedora Sway Atomic and Fedora COSMIC Atomic, you can update the OS manually via the command line.
=== Alternative: Updating using the command line
It is also possible to update using the command line.
To update the system, run:
[source,bash]
----
@ -35,15 +40,30 @@ $ rpm-ostree upgrade --check
[[upgrading]]
== Upgrading between major versions
Upgrading between major versions (such as from Fedora {version-oldstable} to Fedora {version-stable}) can be completed using GNOME Software on Silverblue, Plasma Discover on Kinoite and Budgie Atomic.
Alternatively, Fedora Atomic Desktops can be upgraded between major versions using the `rpm-ostree` command.
On Atomic Desktops, you can keep using your computer while applying major OS updates (such as from Fedora {version-oldstable} to Fedora {version-stable}) as they are downloaded and installed in the background.
Once an update has been installed, you can reboot your computer to start using the new version.
You will not have to wait for the update to be installed either during shutdown or boot up.
[NOTE]
====
It is recommended to update to the latest version of the current major version before upgrading to a new major version.
Make sure to reboot before starting the update to the next major version.
====
On Fedora Silverblue, major version updates can be applied using GNOME Software.
On Fedora Kinoite and Fedora Budgie Atomic, major version updates can be applied using Plasma Discover.
On Fedora Sway Atomic and Fedora COSMIC Atomic, major version updates can be applied using the command line.
[WARNING]
====
Skipping major releases is currently untested and is thus not supported.
Skipping major releases is currently untested and is thus not supported for all Atomic Desktops.
You should update only one major release at a time, i.e. from Fedora {version-oldstable} to {version-stable}, etc.
====
=== Alternative: Upgrading between major versions using the command line
First, make sure that you are running the latest update for the current version:
[source,bash]