mirror of
https://gitee.com/infiniflow/ragflow.git
synced 2025-12-06 15:29:03 +08:00
e3987e21b9
### What problem does this PR solve? Update upgrade guide: add stop server step and rename section ### Type of change - [x] Documentation Update
100 lines
2.4 KiB
Plaintext
100 lines
2.4 KiB
Plaintext
---
|
|
sidebar_position: 11
|
|
slug: /upgrade_ragflow
|
|
---
|
|
|
|
# Upgrading
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
Upgrade RAGFlow to `nightly` or the latest, published release.
|
|
|
|
:::info NOTE
|
|
Upgrading RAGFlow in itself will *not* remove your uploaded/historical data. However, be aware that `docker compose -f docker/docker-compose.yml down -v` will remove Docker container volumes, resulting in data loss.
|
|
:::
|
|
|
|
## Upgrade RAGFlow to `nightly`, the most recent, tested Docker image
|
|
|
|
`nightly` refers to the RAGFlow Docker image without embedding models.
|
|
|
|
To upgrade RAGFlow, you must upgrade **both** your code **and** your Docker image:
|
|
|
|
1. Stop the server
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml down
|
|
```
|
|
|
|
2. Update the local code
|
|
|
|
```bash
|
|
git pull
|
|
```
|
|
|
|
3. Update **ragflow/docker/.env**:
|
|
|
|
```bash
|
|
RAGFLOW_IMAGE=infiniflow/ragflow:nightly
|
|
```
|
|
|
|
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 given release
|
|
|
|
To upgrade RAGFlow, you must upgrade **both** your code **and** your Docker image:
|
|
|
|
1. Stop the server
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml down
|
|
```
|
|
|
|
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
|
|
```
|
|
|
|
4. Update **ragflow/docker/.env**:
|
|
|
|
```bash
|
|
RAGFLOW_IMAGE=infiniflow/ragflow:v0.22.1
|
|
```
|
|
|
|
5. Update the RAGFlow image and restart RAGFlow:
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml pull
|
|
docker compose -f docker/docker-compose.yml up -d
|
|
```
|
|
|
|
## Frequently asked questions
|
|
|
|
### Do I need to back up my datasets before upgrading RAGFlow?
|
|
|
|
No, you do not need to. Upgrading RAGFlow in itself will *not* remove your uploaded data or dataset settings. However, be aware that `docker compose -f docker/docker-compose.yml down -v` will remove Docker container volumes, resulting in data loss.
|
|
|
|
### Upgrade RAGFlow in an offline environment (without Internet access)
|
|
|
|
1. From an environment with Internet access, pull the required Docker image.
|
|
2. Save the Docker image to a **.tar** file.
|
|
```bash
|
|
docker save -o ragflow.v0.22.1.tar infiniflow/ragflow:v0.22.1
|
|
```
|
|
3. Copy the **.tar** file to the target server.
|
|
4. Load the **.tar** file into Docker:
|
|
```bash
|
|
docker load -i ragflow.v0.22.1.tar
|
|
```
|