diff --git a/docs/guides/self-update.md b/docs/guides/self-update.md index 02751fa079..639b54f006 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 97d8a989d0..93b48b1819 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 0ad5ed479c..25ed3e141b 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 03199c30bb..c00f62021c 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