@samitouri / QOSami_Agents_Zero-2 / commits / bfe4119d

quick update flow and migration guidance

Alessandro committed Mar 31, 2026 at 21:53 UTC bfe4119d72d0944dccc0002029837cdc18898e4c
4 files changed +36 -20
docs/guides/self-update.md
+5 -8
@@ -4,11 +4,11 @@
4
5 For day-to-day upgrades inside a running instance:
6
7 -1. **Settings → Update** → open **Self Update**
8 -2. Select the target version
9 -3. Click **Restart and Update**
7 +1. Open **Settings UI → Update** tab
8 +2. Open **Self Update**
9 +3. Wait for the update checker to see if you have the latest version or if there's an available update.
10
11 -The UI will tell you when a new A0 update is available for download.
11 +The UI will tell you when a new A0 update is available for download. Backups are automatically managed internally during the update process.
12
13 ---
14
@@ -39,11 +39,8 @@ Because these files live in `/exe`, you can recover from an older downgraded `/a
39
40 ## Backup behavior
41
42 -The updater can create a zip backup of `/a0/usr` before replacing repository files.
42 +The updater automatically creates a backup of `a0/usr`.
43
44 -- The default backup directory is `/root/update-backups`
45 -- The default file name format is `usr-YYYYMMDD-HHMMSS.zip`
46 -- Conflict handling supports rename, overwrite, or fail-before-restart
44
45 ## Version selection
46
docs/quickstart.md
+1 -1
@@ -18,7 +18,7 @@ irm https://ps.agent-zero.ai | iex
18 Follow the CLI prompts for port and authentication, complete onboarding, then open the Web UI URL from the terminal.
19
20 > [!TIP]
21 -> To update later, use **Settings → Update → Self Update** (see [How to Update](setup/installation.md#how-to-update-agent-zero)). Always create a backup under **Settings → Backup & Restore** first.
21 +> 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.
22
23 > [!NOTE]
24 > For manual Docker Desktop setup, volume mapping, and platform-specific detail, see the [Installation Guide](setup/installation.md#manual-installation-advanced).
docs/setup/installation.md
+17 -4
@@ -31,14 +31,27 @@ Once the install completes, open the URL shown in your terminal to access the We
31
32 ### Self Update (Recommended)
33
34 -Use the built-in updater in the Web UI (since v1.5):
34 +Use the built-in updater in the Web UI:
35
36 -1. Go to **Settings → Update** and open **Self Update**
37 -2. Choose the version you want
38 -3. Click **Restart and Update**
36 +1. Open **Settings UI → Update** tab
37 +2. Open **Self Update**
38 +3. Wait for the update checker to see if you have the latest version or if there's an available update.
39 +
40 +You'll also be prompted through the UI when a new A0 version is released. Backups are automatically managed internally during this process.
41
42 For technical details of the updater, see [Self Update](../guides/self-update.md).
43
44 +### Updating from Pre-v0.9.8
45 +
46 +If you are upgrading from an older version of Agent Zero (v0.9.8 or earlier) to v1.1 or newer, the architecture has fundamentally changed. You cannot use the in-app Self Update. Instead, follow these steps to migrate your data:
47 +
48 +1. **Backup your existing `usr/` directory** (which contains your settings, projects, memory, and custom plugins).
49 +2. **Run the new install script** to set up the new Docker-based architecture:
50 + - macOS / Linux: `curl -fsSL https://bash.agent-zero.ai | bash`
51 + - Windows (PowerShell): `irm https://ps.agent-zero.ai | iex`
52 +3. **Migrate your data:** After the new installation completes, copy the contents of your backed-up `usr/` directory into the new `/a0/usr/` directory created by the script.
53 +4. Restart the container for the changes to take effect.
54 +
55 ### Manual Update (Advanced)
56
57 > Use this only if Self Update is unavailable or you must manage containers yourself (for example, some custom Docker setups).
knowledge/main/about/setup-and-deployment.md
+13 -7
@@ -41,13 +41,19 @@ Settings are saved to `usr/settings.json` immediately on change.
41
42 ## Updating Agent Zero
43
44 -The recommended update process preserves user data:
45 -1. Keep the old container running
46 -2. Pull the new image: `docker pull agent0ai/agent-zero`
47 -3. Start the new container on a different host port
48 -4. In the old instance: Settings → Backup & Restore → Create Backup
49 -5. In the new instance: Settings → Backup & Restore → Restore from Backup
50 -6. Stop the old container
44 +The recommended update process is to use Self Update:
45 +1. Open **Settings UI → Update** tab
46 +2. Open **Self Update**
47 +3. Wait for the update checker to see if you have the latest version or if there's an available update
48 +
49 +You'll also be prompted through the UI when a new A0 version is released. Note that backups are automatically managed internally during the self-update process.
50 +
51 +### Updating from Pre-v0.9.8
52 +
53 +If upgrading from v0.9.8 or earlier, the architecture has significantly changed. You must use the new install scripts and manually migrate your data:
54 +1. Backup your existing `usr/` directory.
55 +2. Run the Quick Install script (`curl -fsSL https://bash.agent-zero.ai | bash` for macOS/Linux or `irm https://ps.agent-zero.ai | iex` for Windows).
56 +3. Copy your backed-up `usr/` contents into the new installation's `a0/usr/` directory to preserve your settings, memory, and plugins.
57
58 ## Remote Access
59