nami alpha Docs

Updates and going back

Keep namiOS up to date, and go back to an earlier version of the computer when something isn't right.

Let it update by itself

namiOS installs updates once a day, in the background: the newest nami, then a new version of the computer with the newest apps. Nothing changes while you work. The new version starts the next time the computer starts.

When a new version is waiting, a notification says Restart to Finish Updating, and Updates in Settings says the same, with Restart Now and what’s new.

Update now

Open Updates in Settings (or Software Updates in All Apps). It checks for updates as it opens, and shows what’s new in the next namiOS and which apps change. Click Update Now to install all of it, then Restart Now.

The same from a terminal:

nami os-update   # an admin; anyone else: sudo nami os-update

Turn automatic updates off

In Updates, turn off Install updates automatically. That writes one line to computer.nami:

/etc/nami/computer.nami
packages:  - namiosupdates: manualusers:  ada: { admin: true }

Updates then install only when someone clicks Update Now. Take the line out, or write updates: auto, to turn them on again. Turning them off with without: [nami-update.timer], as earlier versions did, still works.

Change the computer

Each nami apply of computer.nami makes a new version of the whole system next to the running one, then switches to it. A new kernel is used from the next start.

nami install --for-everyone htop
/etc/nami/computer.nami
packages:  - namios  - htop

Editing the file yourself and running nami apply does the same.

Every version is a change you can go back to, as described in Changes and undo.

See the versions

An admin’s nami history lists the computer’s versions, newest first. The star marks the one that’s running.

nami history
*   14  2026-11-12 08:03 UTC  412 packages
    13  2026-11-11 09:12 UTC  411 packages
    12  as the computer was made  398 packages

namiOS keeps the newest four versions on the disk.

Go back to the apps you had

nami undo puts the apps computer.nami listed at an earlier version back in the file, and applies it.

nami undo       # the version before this one
nami undo 12    # a version by its number
/etc/nami/computer.nami
packages:  - namios  - htop

Newer versions of the same apps, and what namiOS itself brings, don’t go back this way. For those, start an earlier version, as below.

Start an earlier version

Hold Space as the computer starts. The boot menu shows the versions namiOS keeps; choose one to start it.

If a new version fails to start three times in a row, the computer starts the one before it by itself. Nothing is lost: your files and settings are the same in every version.

Something wrong or missing here? nami report tells us, or Report a problem in the nami window.