From e3987e21b968bdec1a6c4a7499c3da9533fe1864 Mon Sep 17 00:00:00 2001
From: Zhichang Yu <yuzhichang@gmail.com>
Date: Tue, 2 Dec 2025 14:51:03 +0800
Subject: [PATCH] Update upgrade guide: add stop server step and rename section
 (#11654)

### What problem does this PR solve?

Update upgrade guide: add stop server step and rename section

### Type of change

- [x] Documentation Update
---
 docs/guides/upgrade_ragflow.mdx | 32 ++++++++++++++++++++++----------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/docs/guides/upgrade_ragflow.mdx b/docs/guides/upgrade_ragflow.mdx
index dbd26060b..eb213d079 100644
--- a/docs/guides/upgrade_ragflow.mdx
+++ b/docs/guides/upgrade_ragflow.mdx
@@ -19,48 +19,60 @@ Upgrading RAGFlow in itself will *not* remove your uploaded/historical data. How
 
 To upgrade RAGFlow, you must upgrade **both** your code **and** your Docker image:
 
-1. Clone the repo
+1. Stop the server
 
    ```bash
-   git clone https://github.com/infiniflow/ragflow.git
+   docker compose -f docker/docker-compose.yml down
    ```
 
-2. Update **ragflow/docker/.env**:
+2. Update the local code
+
+   ```bash
+   git pull
+   ```
+
+3. Update **ragflow/docker/.env**:
 
    ```bash
    RAGFLOW_IMAGE=infiniflow/ragflow:nightly
    ```
 
-3. Update RAGFlow image and restart RAGFlow:
+4. Update RAGFlow image and restart RAGFlow:
 
    ```bash
    docker compose -f docker/docker-compose.yml pull
    docker compose -f docker/docker-compose.yml up -d
    ```
 
-## Upgrade RAGFlow to the most recent, officially published release
+## Upgrade RAGFlow to given release
 
 To upgrade RAGFlow, you must upgrade **both** your code **and** your Docker image:
 
-1. Clone the repo
+1. Stop the server
 
    ```bash
-   git clone https://github.com/infiniflow/ragflow.git
+   docker compose -f docker/docker-compose.yml down
    ```
 
-2. Switch to the latest, officially published release, e.g., `v0.22.1`:
+2. Update the local code
+
+   ```bash
+   git pull
+   ```
+
+3. Switch to the latest, officially published release, e.g., `v0.22.1`:
 
    ```bash
    git checkout -f v0.22.1
    ```
 
-3. Update **ragflow/docker/.env**:
+4. Update **ragflow/docker/.env**:
 
    ```bash
    RAGFLOW_IMAGE=infiniflow/ragflow:v0.22.1
    ```
 
-4. Update the RAGFlow image and restart RAGFlow:
+5. Update the RAGFlow image and restart RAGFlow:
 
    ```bash
    docker compose -f docker/docker-compose.yml pull