Refresh install docs for Launcher and A0 Install
Update the docs index, quickstart, and installation guide to present A0 Launcher, A0 Install, and direct Docker as distinct setup paths. Add the A0 Launcher v0.9 download matrix, document headless installer usage, and align visible architecture labels with the x86/ARM wording.
Alessandro committed
Jun 24, 2026 at 13:08 UTC
6dfd3d5d5b806514ee9baec294a988041952f1f6
3 files changed
+67
-12
docs/README.md
+1
-1
@@ -14,7 +14,7 @@ docs focus on practical setup, screenshots, and user workflows.
14
- **[Quickstart Guide](quickstart.md):** Get up and running in 5 minutes with Agent Zero.
15
- **[Agent Zero Launcher](guides/launcher.md):** Use the desktop app to set up Docker, install Agent Zero, open Instances, or connect a remote Instance.
16
- **[First-Run Onboarding](guides/onboarding.md):** Choose Cloud or Local, add a provider key, and select main and utility models.
17
-- **[Installation Guide](setup/installation.md):** Install scripts, updates, and advanced Docker setup (includes [How to Update](setup/installation.md#how-to-update-agent-zero)).
17
+- **[Installation Guide](setup/installation.md):** A0 Launcher downloads, A0 Install, direct Docker, updates, and advanced Docker setup (includes [How to Update](setup/installation.md#how-to-update-agent-zero)).
18
- **[A0 CLI Connector](guides/a0-cli-connector.md):** Install the host connector for a running Agent Zero instance, use the command palette, and switch Browser modes.
19
- **[Self Update](guides/self-update.md):** How the in-app updater works (technical reference).
20
- **[VPS Deployment](setup/vps-deployment.md):** Deploy Agent Zero on a remote server.
docs/quickstart.md
+7
-5
@@ -5,11 +5,13 @@ Agent Zero, add a model or API key, open the Web UI, and give it a concrete job.
5
6
## Installation (recommended)
7
8
-Run one command; the script handles Docker, image pull, and container setup.
8
+Choose the path that matches your machine:
9
10
-Prefer a desktop app on a fresh machine? Start with
11
-[Agent Zero Launcher](guides/launcher.md). It can set up the local runtime,
12
-download Agent Zero, open Instances, or save a remote Instance URL.
10
+- Use [A0 Launcher](guides/launcher.md) if you want a desktop app on a fresh
11
+ machine. It can set up the local runtime, download Agent Zero, open
12
+ Instances, or save a remote Instance URL.
13
+- Use A0 Install if you want the terminal path. The script handles Docker
14
+ detection, image pull, and container setup.
15
16
**macOS / Linux:**
17
```bash
@@ -27,7 +29,7 @@ Follow the CLI prompts for port and authentication, complete onboarding, then op
29
> To update later, open **Settings UI -> Update tab -> Open Self Update** (see [How to Update](setup/installation.md#how-to-update-agent-zero)). Backups are automatically managed internally.
30
31
> [!NOTE]
30
-> For manual Docker Desktop setup, volume mapping, and platform-specific detail, see the [Installation Guide](setup/installation.md#manual-installation-advanced).
32
+> For Launcher downloads, headless installer flags, direct Docker, manual Docker Desktop setup, volume mapping, and platform-specific detail, see the [Installation Guide](setup/installation.md).
33
34
## Use Agent Zero on your real local files
35
docs/setup/installation.md
+59
-6
@@ -6,24 +6,77 @@
6
7
## Quick Start (Recommended)
8
9
-The install script is the fastest way to get Agent Zero running. It handles Docker, image pulling, and container setup automatically.
9
+Agent Zero runs as a Docker container, and you now have two friendly ways to get
10
+there:
11
11
-**macOS / Linux:**
12
+- **A0 Launcher** is the desktop app. It can download Agent Zero, create and
13
+ manage Instances, and help set up the local container runtime when needed.
14
+- **A0 Install** is the terminal installer. It is best for SSH sessions,
15
+ servers, scripted setup, recovery shells, or users who prefer commands.
16
+
17
+If Docker is already installed and running, you can also start the container
18
+directly.
19
+
20
+### A0 Launcher
21
+
22
+Use **A0 Launcher** when you want the guided desktop path. Download the app for
23
+your platform, open it, and let it check Docker or set up a runtime before it
24
+downloads Agent Zero.
25
+
26
+#### Downloads
27
+
28
+| Architecture | macOS | Linux | Windows |
29
+| --- | --- | --- | --- |
30
+| x86 | [Mac Intel](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-x64.dmg) | [Linux x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-x64.AppImage) | [Windows x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-x64.exe) |
31
+| ARM64 | [Mac Apple Silicon](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-arm64.dmg) | [Linux ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-arm64.AppImage) | [Windows ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-arm64.exe) |
32
+
33
+See the [A0 Launcher v0.9 release](https://github.com/agent0ai/a0-launcher/releases/tag/v0.9)
34
+for release notes and updater metadata. See the
35
+[Launcher guide](../guides/launcher.md) for the first-run walkthrough.
36
+
37
+### A0 Install
38
+
39
+Use **A0 Install** when you want the command-line path. The installer creates a
40
+Dockerized Agent Zero instance, mounts user data to `/a0/usr`, and tries to
41
+reuse an existing Docker-compatible runtime before setting one up.
42
+
43
+#### macOS / Linux
44
```bash
45
curl -fsSL https://bash.agent-zero.ai | bash
46
```
47
16
-**Windows (PowerShell):**
48
+#### Windows PowerShell
49
```powershell
50
irm https://ps.agent-zero.ai | iex
51
```
52
21
-**Docker (run directly):**
53
+#### Headless / scripted
54
+
55
+For servers and automation, Quick Start mode creates one instance and exits
56
+without opening menus:
57
+
58
+```bash
59
+curl -fsSL https://bash.agent-zero.ai | bash -s -- --quick-start --name agent-zero --port 5080
60
+```
61
+
62
+```powershell
63
+& ([scriptblock]::Create((irm https://ps.agent-zero.ai))) -QuickStart -Name agent-zero -Port 5080
64
+```
65
+
66
+Use `--skip-runtime-setup` / `-SkipRuntimeSetup` when Docker must already be
67
+working and the installer should not try to set up a runtime. See the
68
+[A0 Install repository](https://github.com/agent0ai/a0-install) for all
69
+installer flags.
70
+
71
+### Docker already installed? Run this directly
72
+
73
```bash
23
-docker run -p 80:80 agent0ai/agent-zero
74
+docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero
75
```
76
26
-Once the install completes, open the URL shown in your terminal to access the Web UI. Follow the prompts in the CLI to set your port and authentication, complete onboarding, add your API key, then continue to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
77
+Once the install completes, open the URL shown in your terminal or Launcher to
78
+access the Web UI. Complete onboarding, add your model provider or API key, then
79
+continue to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
80
81
> [!TIP]
82
> Need Agent Zero to reach host-machine files, shell, or a host browser? Install the optional [A0 CLI Connector](../guides/a0-cli-connector.md), then run `a0` to connect your terminal to this Agent Zero instance.