Merge pull request #1404 from 3clyp50/ready

quick update flow and migration guidance

Author: nicolasleao

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
 

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).

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).

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