ContextQMD
Back to Ragflow

Upgrading

docs/administrator/upgrade_ragflow.mdx

0.25.12.4 KB
Original Source

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.25.1:

    bash
    git checkout -f v0.25.1

  4. Update ragflow/docker/.env:

    bash
    RAGFLOW_IMAGE=infiniflow/ragflow:v0.25.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.25.1.tar infiniflow/ragflow:v0.25.1
  3. Copy the .tar file to the target server.
  4. Load the .tar file into Docker:
    bash
    docker load -i ragflow.v0.25.1.tar