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.