Merge pull request #1398 from 3clyp50/docsupdate

Author: frdel

docs/README.md

@@ -6,7 +6,8 @@ Welcome to the Agent Zero documentation hub. Whether you're getting started or d
 ## Quick Start
 
 - **[Quickstart Guide](quickstart.md):** Get up and running in 5 minutes with Agent Zero.
-- **[Installation Guide](setup/installation.md):** Detailed setup instructions for all platforms (or [update your installation](setup/installation.md#how-to-update-agent-zero)).
+- **[Installation Guide](setup/installation.md):** Install scripts, updates, and advanced Docker setup (includes [How to Update](setup/installation.md#how-to-update-agent-zero)).
+- **[Self Update](guides/self-update.md):** How the in-app updater works (technical reference).
 - **[VPS Deployment](setup/vps-deployment.md):** Deploy Agent Zero on a remote server.
 - **[Development Setup](setup/dev-setup.md):** Set up a local development environment.
 
@@ -45,6 +46,8 @@ Welcome to the Agent Zero documentation hub. Whether you're getting started or d
 - [Quick Start](#quick-start)
   - [Quickstart Guide](quickstart.md)
   - [Installation Guide](setup/installation.md)
+    - [How to Update Agent Zero](setup/installation.md#how-to-update-agent-zero)
+    - [Manual Installation (Advanced)](setup/installation.md#manual-installation-advanced)
     - [Step 1: Install Docker Desktop](setup/installation.md#step-1-install-docker-desktop)
       - [Windows Installation](setup/installation.md#-windows-installation)
       - [macOS Installation](setup/installation.md#-macos-installation)
@@ -63,7 +66,7 @@ Welcome to the Agent Zero documentation hub. Whether you're getting started or d
     - [Choosing Your LLMs](setup/installation.md#choosing-your-llms)
     - [Installing Ollama (Local Models)](setup/installation.md#installing-and-using-ollama-local-models)
     - [Using on Mobile Devices](setup/installation.md#using-agent-zero-on-your-mobile-device)
-    - [How to Update Agent Zero](setup/installation.md#how-to-update-agent-zero)
+  - [Self Update (technical)](guides/self-update.md)
   - [VPS Deployment](setup/vps-deployment.md)
   - [Development Setup](setup/dev-setup.md)
 

docs/guides/self-update.md

@@ -1,5 +1,19 @@
 # Self Update
 
+## Using Self Update in the Web UI
+
+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**
+
+The UI will tell you when a new A0 update is available for download.
+
+---
+
+## Technical reference
+
 Agent Zero includes a Docker-oriented self-update flow for switching to a specific repository version tag on `main`, `testing`, or `development`.
 
 ## How it works

docs/quickstart.md

@@ -1,55 +1,44 @@
 # Quick Start
-This guide provides a quick introduction to using Agent Zero. We'll cover the essential installation steps and running your first Skill.
+This guide provides a quick introduction to using Agent Zero. We'll cover the recommended install path and running your first Skill.
 
-## Installation Steps
+## Installation (recommended)
 
-### Step 1: Install Docker Desktop
-
-Download and install Docker Desktop for your operating system:
-
-- **Windows:** Download from [Docker Desktop](https://www.docker.com/products/docker-desktop/) and run the installer with default settings
-- **macOS:** Download for Apple Silicon or Intel, drag to Applications, and enable the Docker socket in Settings → Advanced
-- **Linux:** Install Docker Desktop or docker-ce following the [official instructions](https://docs.docker.com/desktop/install/linux-install/)
-
-> [!TIP]
-> For complete OS-specific installation instructions, see the [full Installation Guide](setup/installation.md#step-1-install-docker-desktop).
-
-### Step 2: Pull the Agent Zero Image
-
-Using Docker Desktop GUI, search for `agent0ai/agent-zero` and click Pull, or use the terminal:
+Run one command; the script handles Docker, image pull, and container setup.
 
+**macOS / Linux:**
 ```bash
-docker pull agent0ai/agent-zero
+curl -fsSL https://bash.agent-zero.ai | bash
 ```
 
-### Step 3: Run the Container
-
-**Using Docker Desktop:** Go to Images tab, click Run next to `agent0ai/agent-zero`, open Optional settings, map a host port to container port `80` (use `0` for automatic assignment), then click Run.
+**Windows (PowerShell):**
+```powershell
+irm https://ps.agent-zero.ai | iex
+```
 
-**Using Terminal:**
+Follow the CLI prompts for port and authentication, complete onboarding, then open the Web UI URL from the terminal.
 
-```bash
-docker run -p 0:80 agent0ai/agent-zero
-```
+> [!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.
 
-The container will start in a few seconds. Find the mapped port in Docker Desktop (shown as `<PORT>:80`).
+> [!NOTE]
+> For manual Docker Desktop setup, volume mapping, and platform-specific detail, see the [Installation Guide](setup/installation.md#manual-installation-advanced).
 
-### Step 4: Open the Web UI and Configure API Key
+### Open the Web UI and configure your API key
 
-Open your browser and navigate to `http://localhost:<PORT>`. The Web UI will show a warning banner about missing API key.
+Open your browser and navigate to `http://localhost:<PORT>`. The Web UI will show the onboarding banner. Click Start Onboarding to set your AI models and API key.
 
 ![Agent Zero Web UI](res/setup/6-docker-a0-running-new.png)
 
 Click **Add your API key** to open Settings and configure:
 
 - **Default Provider:** OpenRouter (supports most models with a single API key)
 - **Alternative Providers:** Anthropic, OpenAI, Ollama/LM Studio (local models), and many others
-- **Model Selection:** Choose your chat model (e.g., `anthropic/claude-sonnet-4-5` for OpenRouter)
+- **Model Selection:** Choose your chat model (e.g., `anthropic/claude-sonnet-4-6` for OpenRouter)
 
 > [!NOTE]
 > Agent Zero supports any LLM provider, including local models via Ollama. For detailed provider configuration and local model setup, see the [Installation Guide](setup/installation.md#choosing-your-llms).
 
-### Step 5: Start Your First Chat
+### Start your first chat
 
 Once configured, you'll see the Agent Zero dashboard with access to:
 

docs/setup/installation.md

@@ -23,13 +23,46 @@ irm https://ps.agent-zero.ai | iex
 docker run -p 80:80 agent0ai/agent-zero
 ```
 
-Once the install completes, open the URL shown in your terminal to access the Web UI and proceed to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
+Once the install completes, open the URL shown in your terminal to access the Web UI. Follow the prompts in the CLI to set your port and authentication, complete onboarding, add your API key, then continue to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
 
 ---
 
-## Manual Docker Setup
+## How to Update Agent Zero
+
+### Self Update (Recommended)
+
+Use the built-in updater in the Web UI (since v1.5):
+
+1. Go to **Settings → Update** and open **Self Update**
+2. Choose the version you want
+3. Click **Restart and Update**
+
+For technical details of the updater, see [Self Update](../guides/self-update.md).
+
+### Manual Update (Advanced)
+
+> Use this only if Self Update is unavailable or you must manage containers yourself (for example, some custom Docker setups).
+
+1. Keep the current container running
+2. `docker pull agent0ai/agent-zero:latest`
+3. Start a **new** container on a different host port, for example: `docker run -d -p 50081:80 --name agent-zero-new agent0ai/agent-zero`
+4. On the **old** instance: **Settings → Backup & Restore → Create Backup**
+5. On the **new** instance: **Restore** the backup
+6. Verify chats and data, then remove the old container
+
+> [!CAUTION]
+> Do not delete the old container until the new one has your data.
+
+> [!TIP]
+> If the new instance fails to load settings, remove `/a0/usr/settings.json` and restart to regenerate default settings.
+
+---
+
+## Manual Installation (Advanced)
 
-If you prefer to set things up manually, follow the steps below.
+> Users should use [Quick Start (Recommended)](#quick-start-recommended) above. The steps below are for custom Docker setups, air-gapped installs, or when you cannot use the install scripts.
+
+Follow the steps below to install Docker and run the image by hand.
 
 ### Step 1: Install Docker Desktop
 
@@ -494,24 +527,6 @@ ollama rm <model-name>
 
 ---
 
-## How to Update Agent Zero
-
-> [!NOTE]
-> Since v0.9, Agent Zero includes a Backup & Restore workflow in the Settings UI. This is the **safest** way to upgrade Docker instances.
-
-### Recommended Update Process (Docker)
-
-1. **Keep the old container running** and note its port.
-2. **Pull the new image** (`agent0ai/agent-zero:latest`).
-3. **Start a new container** on a different host port.
-4. In the **old** instance, open **Settings → Backup & Restore** and create a backup.
-5. In the **new** instance, restore that backup from the same panel.
-
-> [!TIP]
-> If the new instance fails to load settings, remove `/a0/usr/settings.json` and restart to regenerate default settings.
-
----
-
 ## Using Agent Zero on Your Mobile Device
 
 Agent Zero can be accessed from mobile devices and other computers using the built-in **Tunnel feature**.