Agent Zero AI framework
quick update flow and migration guidance
Alessandrobfe4119d72d0
diff --git a/docs/guides/self-update.md b/docs/guides/self-update.mdindex 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 selectiondiff --git a/docs/quickstart.md b/docs/quickstart.mdindex 97d8a989d..93b48b181 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -18,7 +18,7 @@ irm https://ps.agent-zero.ai | iexFollow 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.mdindex 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.mdindex 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