Skip to content

Agent Zero AI framework

quick update flow and migration guidance

Alessandrobfe4119d72d0
diff --git a/docs/guides/self-update.md b/docs/guides/self-update.md
index 02751fa07..639b54f00 100644
--- a/docs/guides/self-update.md
+++ b/docs/guides/self-update.md
@@ -4,11 +4,11 @@
For day-to-day upgrades inside a running instance:
-1. **Settings → Update** → open **Self Update**
-2. Select the target version
-3. Click **Restart and Update**
+1. Open **Settings UI → Update** tab
+2. Open **Self Update**
+3. Wait for the update checker to see if you have the latest version or if there's an available update.
-The UI will tell you when a new A0 update is available for download.
+The UI will tell you when a new A0 update is available for download. Backups are automatically managed internally during the update process.
---
@@ -39,11 +39,8 @@ Because these files live in `/exe`, you can recover from an older downgraded `/a
## Backup behavior
-The updater can create a zip backup of `/a0/usr` before replacing repository files.
+The updater automatically creates a backup of `a0/usr`.
-- The default backup directory is `/root/update-backups`
-- The default file name format is `usr-YYYYMMDD-HHMMSS.zip`
-- Conflict handling supports rename, overwrite, or fail-before-restart
## Version selection
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 97d8a989d..93b48b181 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -18,7 +18,7 @@ irm https://ps.agent-zero.ai | iex
Follow the CLI prompts for port and authentication, complete onboarding, then open the Web UI URL from the terminal.
> [!TIP]
-> 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.
+> 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.
> [!NOTE]
> For manual Docker Desktop setup, volume mapping, and platform-specific detail, see the [Installation Guide](setup/installation.md#manual-installation-advanced).
diff --git a/docs/setup/installation.md b/docs/setup/installation.md
index 0ad5ed479..25ed3e141 100644
--- a/docs/setup/installation.md
+++ b/docs/setup/installation.md
@@ -31,14 +31,27 @@ Once the install completes, open the URL shown in your terminal to access the We
### Self Update (Recommended)
-Use the built-in updater in the Web UI (since v1.5):
+Use the built-in updater in the Web UI:
-1. Go to **Settings → Update** and open **Self Update**
-2. Choose the version you want
-3. Click **Restart and Update**
+1. Open **Settings UI → Update** tab
+2. Open **Self Update**
+3. Wait for the update checker to see if you have the latest version or if there's an available update.
+
+You'll also be prompted through the UI when a new A0 version is released. Backups are automatically managed internally during this process.
For technical details of the updater, see [Self Update](../guides/self-update.md).
+### Updating from Pre-v0.9.8
+
+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:
+
+1. **Backup your existing `usr/` directory** (which contains your settings, projects, memory, and custom plugins).
+2. **Run the new install script** to set up the new Docker-based architecture:
+ - macOS / Linux: `curl -fsSL https://bash.agent-zero.ai | bash`
+ - Windows (PowerShell): `irm https://ps.agent-zero.ai | iex`
+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.
+4. Restart the container for the changes to take effect.
+
### Manual Update (Advanced)
> Use this only if Self Update is unavailable or you must manage containers yourself (for example, some custom Docker setups).
diff --git a/knowledge/main/about/setup-and-deployment.md b/knowledge/main/about/setup-and-deployment.md
index 03199c30b..c00f62021 100644
--- a/knowledge/main/about/setup-and-deployment.md
+++ b/knowledge/main/about/setup-and-deployment.md
@@ -41,13 +41,19 @@ Settings are saved to `usr/settings.json` immediately on change.
## Updating Agent Zero
-The recommended update process preserves user data:
-1. Keep the old container running
-2. Pull the new image: `docker pull agent0ai/agent-zero`
-3. Start the new container on a different host port
-4. In the old instance: Settings → Backup & Restore → Create Backup
-5. In the new instance: Settings → Backup & Restore → Restore from Backup
-6. Stop the old container
+The recommended update process is to use Self Update:
+1. Open **Settings UI → Update** tab
+2. Open **Self Update**
+3. Wait for the update checker to see if you have the latest version or if there's an available update
+
+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.
+
+### Updating from Pre-v0.9.8
+
+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:
+1. Backup your existing `usr/` directory.
+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).
+3. Copy your backed-up `usr/` contents into the new installation's `a0/usr/` directory to preserve your settings, memory, and plugins.
## Remote Access