Skip to main content
Version: DEV

Upgrading

Upgrade RAGFlow to nightly-slim/nightly or the latest, published release.

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-slim/nightly, the most recent, tested Docker image

nightly-slim refers to the RAGFlow Docker image without embedding models, while nightly refers to the RAGFlow Docker image with embedding models. For details on their differences, see ragflow/docker/.env.

To upgrade RAGFlow, you must upgrade both your code and your Docker image:

  1. Clone the repo

    git clone https://github.com/infiniflow/ragflow.git
  2. Update ragflow/docker/.env:

RAGFLOW_IMAGE=infiniflow/ragflow:nightly-slim
  1. Update RAGFlow image and restart RAGFlow:

    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

To upgrade RAGFlow, you must upgrade both your code and your Docker image:

  1. Clone the repo

    git clone https://github.com/infiniflow/ragflow.git
  2. Switch to the latest, officially published release, e.g., v0.19.1:

    git checkout -f v0.19.1
  3. Update ragflow/docker/.env as follows:

    RAGFLOW_IMAGE=infiniflow/ragflow:v0.19.1
  4. Update the RAGFlow image and restart RAGFlow:

    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 knowledge bases before upgrading RAGFlow?

No, you do not need to. Upgrading RAGFlow in itself will not remove your uploaded data or knowledge base 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.
    docker save -o ragflow.v0.19.1.tar infiniflow/ragflow:v0.19.1
  3. Copy the .tar file to the target server.
  4. Load the .tar file into Docker:
    docker load -i ragflow.v0.19.1.tar