Documentation
Agent Zero Launcher
Agent Zero Launcher is the desktop app for installing, running, switching, and opening Agent Zero Instances without starting from Docker commands.
Download it from the A0 Launcher v1.0 release, then open the app and let it check your local runtime.
Start Fresh On A New Machine
- Open Agent Zero Launcher.
- If Docker is not reachable, follow the setup dialog.
- If Agent Zero already runs on a VPS or another computer, choose Add remote Instance.
- After the runtime is ready, install or run an Agent Zero image from Installs.
- Open the Instance Web UI and complete onboarding.
Runtime Setup
On a fresh machine, Launcher first checks whether a local container runtime is available. If it is missing or stopped, the setup dialog keeps the decision focused: continue setup, refresh after starting Docker yourself, or add an existing remote Agent Zero URL.
Installs
When Docker is ready, Launcher opens to Installs. This page shows the rolling latest and ready image cards first, then grouped version cards for pinned Agent Zero releases such as v2.1 and v2.0.
| Card | Meaning |
|---|---|
| latest | Tracks the newest published Agent Zero release image. |
| ready | Tracks the development-ready image when you intentionally use that branch. |
| Version cards | Pinned release images such as 2.1, 2.0, or older release lines. |
| Install | Downloads that image. |
| Update | Refreshes an installed image when a newer build is available for that card. |
| Run | Starts an installed image as a local Instance. |
Instances
Open Instances after you run Agent Zero. Instance cards hold local containers and saved remote URLs.
- Open UI opens the Agent Zero Web UI from the Instance card.
- Start, Stop, Rename, and Delete act on that Instance.
- Logs and storage actions stay with the Instance they affect.
- Backup
/a0/usrdownloads the same user-data backup zip you can create from Agent Zero Core. - Restore
/a0/usrrestores that backup zip into the selected Instance. - Open A0 CLI appears when the host connector is installed and an Instance URL is available.
Updating With Launcher
Update Agent Zero Images
Use Web UI Self Update for same-major Agent Zero updates. For a major image jump such as v1.20 to v2.0, use Backup /a0/usr on the old Instance, run the v2.0 image from the latest card in Installs, then use Restore /a0/usr on the new Instance.
See the v1.20 to v2.0 update guide for the conservative backup-first path.
Update The Launcher App
When a Launcher app update is available, start Launcher and click the Update button that appears at startup. If you skip it, you can close and reopen Launcher, or simply update the next time you run it.
During the download, Launcher shows progress on the startup screen. Let the download finish, then continue into the app normally.