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