← All documentation

Everyday

Installing software

apm is the one way software arrives on AOS. Every package keeps to two folders, so removing it leaves nothing behind.

One way in: apm

Everything you install, whether from Software or the Terminal, comes through apm, the AOS package manager. There is no second store, no Flatpak or Snap, and no “download this installer and run it”.

In Software, find an app and press Install. In the Terminal:

apm find firefox
apm info mozilla/firefox
apm install mozilla/firefox
apm remove mozilla/firefox
apm list
apm upgrade

Installing for everyone on the machine needs an administrator’s password once every 15 minutes (see Root and administration). apm asks for it by itself.

Official and third-party

Official Third-party
Who builds it AOS, for every release The program’s vendor, packaged for AOS
Tested With each release Checked to start, and may break with an update
Examples Notepad, Clock, cmake, Rust, Go Firefox, Steam, VS Code, Discord, Node.js
Sandbox Yes, for apps Yes, for apps
How to get it Always on Software → Third-party, switched on once

Third-party apps are labelled as such everywhere they appear. That is the deal: the programs you expect are there, and it’s clear which ones AOS stands behind.

You can also add other repositories in Software → Third-party → Add a repository. Their key is remembered the first time, and they are marked not part of AOS.

The two folders

Every package keeps to exactly two places:

Folder What’s in it
/opt/apm/packages/<org>/<name>/ The program itself, read-only, the same for every account
~/AppData/<org>.<name>/ Your data for it: settings, caches, downloads, logins

For example, Firefox lives in /opt/apm/packages/mozilla/firefox/, and your profile in ~/AppData/mozilla.firefox/. Nothing is spread over your home or the system. That is what makes Software show exactly what is installed, and why removing an app plus its folder leaves nothing behind. An app’s page in Software has Its folder, Clear cache and Delete its data.

Updates

App updates arrive together with OS updates in Software → Updates. If an update misbehaves, Use previous version goes back. An app that crashes right after an update starts with its previous version by itself.

Just for you

A package file (.apkg) can be installed for your account only, with no password:

apm --user install ./tool.apkg

It goes into ~/.apm and shows under User Installed in Software. It can’t open network ports.

Command-line tools

Compilers and tools such as cmake, ripgrep, gh or node install the same way and appear on your PATH in the Terminal. They are not sandboxed: they run as you. See Working on your own projects.