What the password protects
This page is not boilerplate. It is the consequence of three decisions that are individually reasonable and, together, mean exactly what the box above says.
Why it is true
Section titled “Why it is true”Agents run as the aos user, and that user can become root. Privileged work — installing a
package, editing something under /etc, restarting a service — goes through a Privileged Tool,
which stops and asks you for an Approval and records what happened in the
Audit Log. The asking is real: nothing privileged happens without
a human saying yes. But the authority is real too. The account that answers those questions is
the account that holds root.
Agents can write outside their own home. On a native install the machine is your server, so
Agents read the whole filesystem and can write most of it. A short list is protected — /boot,
/proc, /sys, /root, other users’ home directories, and Agentic OS’s own binaries and
configuration — and writing to anything else you mark as protected asks first. Everything else is
theirs to change.
The sign-in page is on the public internet. The daemon binds 0.0.0.0 so you can open the
Desktop from your laptop. Scanners will find port 7700 within hours of the install. That is
survivable — it is one password form, rate-limited, with a lockout — but it means the password is
load-bearing from the first minute.
What to actually do
Section titled “What to actually do”- Choose a real password. Twelve characters is the enforced minimum and it is a floor, not a target. Use a password manager and a generated passphrase. The initial password the installer printed is refused as your new one.
- Change it on first sign-in. You will be made to; do not work around it. The initial password was printed to a terminal and written to a file, and it is blanked from that file the moment you replace it.
- Put TLS in front if the server holds anything real. Plain HTTP means your password crosses the network in the clear, and any network between you and the server can read it.
- Know the recovery path before you need it. There is no email reset, because there is no
email.
sudo aos user passwdover SSH is the only way back in. If you lose both the password and your SSH access, you have lost the machine.
If this is more authority than you want to hand over
Section titled “If this is more authority than you want to hand over”Run it with Docker Compose instead. Agents get a full Ubuntu machine and the same Desktop, but it is the container’s filesystem, not your server’s, and the blast radius of a bad Task stops at the container. You give up the thing the native install exists for — Agents that can actually administer your server — and in exchange you get a mistake you can delete.