← All documentation

Start here

Install, updates and recovery

Try AOS from a USB stick, install it, and let it update itself, with two copies of the system so an update can never leave you stranded.

What you need

  • A 64-bit PC from roughly the last fifteen years (x86-64-v2), that starts in UEFI mode.
  • A USB stick of 2 GB or more.
  • A disk of at least 16 GB. Installing erases the whole disk: there is no dual boot.
  • For NVIDIA graphics, an RTX 20 series card or newer.

Try it live

  1. Download the ISO and check it. See Download.
  2. Write it to the stick with dd, Rufus (in DD mode) or Etcher.
  3. Start the PC from the stick’s UEFI entry. If Secure Boot is on, a blue MokManager screen appears once. Choose Enroll key from disk → AOS_ESP → ENROLL_THIS_KEY_IN_MOKMANAGER.cer and confirm.

The live desktop starts without a password. Nothing is written to your disk until you install.

Install

Press Super and start Install AOS. It asks for the licence, keyboard, time zone and disk, then installs. Tick Also encrypt the whole disk if you want it. With a TPM, the disk then unlocks by itself, and the passphrase you chose becomes your recovery key.

If Secure Boot was off during the install, the last page shows an 8-digit password. MokManager asks for it on the next start.

First start

You choose the keyboard and time zone again, then your name and password. That first account is the administrator. Then:

  • A recovery key is shown, once. Write it down. It opens your home if you forget your password, and it is stored nowhere else.
  • You are asked whether you agree to send bug reports. The answer is no unless you say yes.

How the disk is laid out

Part What’s in it
Two system slots (A and B) The read-only OS. One is in use, the other receives the next update
The aos partition Your homes, your installed apps (/opt/apm) and your system settings

Updates only ever replace a system slot. Your files, apps and settings are never touched by an OS update.

Updates

AOS looks for updates two minutes after start and then daily, and a notification tells you when there are some. Open Software → Updates and press Upgrade system. Your apps and the OS update in one step. When the OS part is ready, press Restart.

What happens underneath:

  1. The new release is downloaded, its signature is checked, and it is written into the slot you are not using.
  2. The next start tries the new slot on trial, with three tries.
  3. When the desktop comes up, the new version confirms itself after about 20 seconds.
  4. If it never reaches the desktop, the machine starts the old slot again by itself.

An update that is interrupted, by a flat battery for example, leaves the current system as it was.

Channels

  • Edge (the default) gets every release.
  • Stable gets a release only after it has run on edge for at least a week with nothing found.

Switch to stable with Software → Updates → Follow the stable channel.

Rolling an app back

If an app update misbehaves, its page in Software has Use previous version.

Going back to the previous version of AOS

Hold Space while the PC starts to see the boot menu, and choose the other slot. The same menu has safe graphics (without the GPU driver) for when the screen stays black.

Recovery

For a black screen or a desktop that won’t start, see When something goes wrong, which walks through it step by step.

If the desktop or the login screen keeps crashing, AOS opens a recovery screen instead. It offers:

  • Try again
  • Go back to the previous version of AOS (asks for an administrator’s password)
  • Save a report to a USB stick, or Send a report
  • Command line, Restart and Power off

To report a problem, see Report a bug. Settings → About → Save Report gathers what we need, and you can attach the file.

Power and hibernation

Closing the lid suspends the machine. Hibernation needs an encrypted disk. Turn it on in Settings → Power → Hibernation, which can also hibernate after the machine has been asleep with the lid closed for a while. Power profiles are in the quick panel.