Documentation
How AOS works.
New here? Start with the desktop, then read about the sandbox and root: they explain most of what feels different. Each page stands on its own.
Start here
The desktop and its design
One desktop, one way to do things: the bar, windows, the launcher and how they fit together.
- ade, the desktop
- Bar, dock and launcher
- Windows and tiling
- Two displays
- Keyboard shortcuts
Install, updates and recovery
From the USB stick to an installed machine that updates itself and falls back if an update fails.
- Try it live
- Installing
- Two system slots
- Updates
- Recovery
When something goes wrong
Black screen at start, a desktop that keeps crashing, a bad update: what to do, step by step.
- Black screen
- The boot menu
- Safe graphics
- Recovery screen
- Forgotten password
The built-in apps
Settings, Software, Files, Terminal and the rest: what each one is for.
- Settings
- Software
- Files
- Terminal
- Media Writer
Everyday
Installing software
apm, the one package manager: official packages, third-party packages, and where they keep their files.
- apm
- Official and third-party
- The two folders
- Removing cleanly
Networking and VPN
Wi-Fi and wired networks, how VPNs work on AOS, and how to set up your own.
- Wi-Fi and Ethernet
- WireGuard
- OpenVPN
- Your own VPN server
- What a VPN can see
Security
How AOS keeps you safe
A read-only core, Secure Boot, encrypted homes and no telemetry.
- Read-only core
- Secure Boot
- Encrypted homes
- Privacy
The sandbox
How third-party apps are boxed in, what they can see, and how you grant them more.
- What an app sees
- Permissions
- Camera and microphone
- Files and portals
Root and administration
There is no sudo. How admin tasks work, and what you can do without root.
- No sudo
- aos-rootd
- Administrators
- Without root
Build
Working on your own projects
Toolchains, where code and data belong, and keeping your home clean.
- Toolchains through apm
- Debugging with lldb
- Where things go
- git and ssh
AI tools: inside and outside the sandbox
Running Claude Code and other AI agents, and the difference the sandbox makes.
- Sandboxed agents
- Agents in the Terminal
- Workspaces
- Choosing
Making and publishing apps
Build a native app with the AOS SDK or package an existing one, and what your app is allowed to do.
- Packaging
- Permissions
- Editors and workspaces
- Publishing
- The AOS SDK