mirror of
https://github.com/infiniflow/ragflow.git
synced 2026-11-11 05:40:52 +08:00
68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
---
|
||
sidebar_position: 3
|
||
title: Switch Document Engine
|
||
sidebar_label: Switch Document Engine
|
||
slug: /switch_doc_engine
|
||
sidebar_custom_props: {
|
||
categoryIcon: LucideShuffle
|
||
}
|
||
---
|
||
# Switch Document Engine
|
||
|
||
Switch your doc engine from Elasticsearch to Infinity or OpenSearch.
|
||
|
||
---
|
||
|
||
RAGFlow uses Elasticsearch by default for storing full text and vectors. To switch to [Infinity](https://github.com/infiniflow/infinity/), follow these steps:
|
||
|
||
1. Back up the existing deployment before switching engines. Switching engines creates a new document-index store; reindex the documents after startup.
|
||
|
||
2. Stop the Go deployment:
|
||
|
||
```bash
|
||
docker compose --env-file docker/.env -f docker/docker-compose.yml down
|
||
```
|
||
|
||
:::caution WARNING
|
||
Do not add `-v` unless you intentionally want to delete the deployment's data volumes.
|
||
:::
|
||
|
||
3. Set `DOC_ENGINE=infinity` in **docker/.env**.
|
||
|
||
4. Start the Go deployment:
|
||
|
||
```bash
|
||
docker compose --env-file docker/.env -f docker/docker-compose.yml up -d
|
||
```
|
||
|
||
5. Reindex the documents and verify retrieval before retiring the previous document-engine data.
|
||
|
||
## Switch to OpenSearch
|
||
|
||
OpenSearch is supported as an alternative to Elasticsearch. Hybrid (BM25 + vector) retrieval requires OpenSearch 2.10 or later, which provides the normalization search pipeline the Go engine provisions on startup.
|
||
|
||
1. Set `DOC_ENGINE=opensearch` in **docker/.env** and configure the connection:
|
||
|
||
```bash
|
||
OS_HOST=opensearch39 # compose service name of the OpenSearch container
|
||
OS_PORT=1201 # host port; the container listens on 9201
|
||
OS_USER=admin
|
||
OPENSEARCH_PASSWORD=infini_rag_flow_OS_01
|
||
```
|
||
|
||
2. The `os` section of **conf/service_conf.yaml** mirrors these settings:
|
||
|
||
```yaml
|
||
os:
|
||
hosts: 'http://opensearch39:9201'
|
||
username: 'admin'
|
||
password: 'infini_rag_flow_OS_01'
|
||
# insecure_skip_verify: true # HTTPS only, self-signed dev clusters
|
||
```
|
||
|
||
For an `https://` cluster the server certificate is verified against the
|
||
system trust store. Set `insecure_skip_verify: true` only for a development
|
||
cluster with a self-signed certificate.
|
||
|
||
3. Start the deployment and reindex the documents, as in the Infinity steps above. The index template in **conf/os_mapping.json** declares `knn_vector` fields for the common embedding dimensions (128–10240); an embedding model whose dimension is not listed there cannot be indexed until a matching template is added.
|