ragflow/docker/README.md

README

📕 Table of Contents

• 🐳 Docker Compose
• 🐬 Docker environment variables
• 🐋 Service configuration

🐳 Docker Compose

• docker-compose.yml
• docker-compose-base.yml

🐬 Docker environment variables

The .env file contains important environment variables for Docker.

Elasticsearch

• STACK_VERSION
  The version of Elasticsearch. Defaults to 8.11.3
• ES_PORT
  The port used to expose the Elasticsearch service to the host machine, allowing external access to the service running inside the Docker container. Defaults to 1200.
• ELASTIC_PASSWORD
  The password for Elasticsearch. When updated, you must revise the es.password entry in service_conf.yaml accordingly.

Kibana

• KIBANA_PORT
  The port used to expose the Kibana service to the host machine. Defaults to 6601.
• KIBANA_USER
  The username for Kibana. Defaults to rag_flow.
• KIBANA_PASSWORD
  The password for Kibana. Defaults to infini_rag_flow.

Resource management

• MEM_LIMIT
  The maximum amount of the memory that a specific Docker container can use while running. Defaults to 8073741824.

MySQL

• MYSQL_PASSWORD
  The password for MySQL. When updated, you must revise the mysql.password entry in service_conf.yaml accordingly.
• MYSQL_PORT
  The port used to expose the MySQL service to the host machine, allowing external access to the MySQL database running inside the Docker container. Defaults to 5455.

MinIO

• MINIO_CONSOLE_PORT
  The port used to expose the MinIO console interface to the host machine, allowing external access to the web-based console running inside the Docker container. Defaults to 9001
• MINIO_PORT
  The port used to expose the MinIO API service to the host machine, allowing external access to the MinIO object storage service running inside the Docker container. Defaults to 9000.
• MINIO_USER
  The username for MinIO. When updated, you must revise the minio.user entry in service_conf.yaml accordingly.
• MINIO_PASSWORD
  The password for MinIO. When updated, you must revise the minio.password entry in service_conf.yaml accordingly.

Redis

• REDIS_PORT
  The port used to expose the Redis service to the host machine, allowing external access to the Redis service running inside the Docker container. Defaults to 6379.
• REDIS_PASSWORD
  The password for Redis. When updated, you must revise the redis.password entry in service_conf.yaml accordingly.

RAGFlow

• SVR_HTTP_PORT
  The port used to expose RAGFlow's HTTP API service to the host machine, allowing external access to the service running inside the Docker container. Defaults to 9380.

• RAGFLOW-IMAGE
  The Docker image edition. Available editions:

  • infiniflow/ragflow:dev-slim (default): The RAGFlow Docker image without embedding models.
  • infiniflow/ragflow:dev: The RAGFlow Docker image with embedding models including:
    • Embedded embedding models:
      • BAAI/bge-large-zh-v1.5
      • BAAI/bge-reranker-v2-m3
      • maidalun1020/bce-embedding-base_v1
      • maidalun1020/bce-reranker-base_v1
    • Embedding models that will be downloaded once you select them in the RAGFlow UI:
      • BAAI/bge-base-en-v1.5
      • BAAI/bge-large-en-v1.5
      • BAAI/bge-small-en-v1.5
      • BAAI/bge-small-zh-v1.5
      • jinaai/jina-embeddings-v2-base-en
      • jinaai/jina-embeddings-v2-small-en
      • nomic-ai/nomic-embed-text-v1.5
      • sentence-transformers/all-MiniLM-L6-v2

  Tip

  If you cannot download the RAGFlow Docker image, try the following mirrors.

  • For dev-slim:
    • RAGFLOW_IMAGE=swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow:dev-slim or,
    • RAGFLOW_IMAGE=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:dev-slim.
  • For dev:
    • RAGFLOW_IMAGE=swr.cn-north-4.myhuaweicloud.com/infiniflow/ragflow:dev or,
    • RAGFLOW_IMAGE=registry.cn-hangzhou.aliyuncs.com/infiniflow/ragflow:dev.

Miscellaneous

• TIMEZONE
  The local time zone. Defaults to 'Asia/Shanghai'.

🐋 Service configuration

service_conf.yaml specifies the system-level configuration for RAGFlow and is used by its API server and task executor.

• ragflow

  • host: The API server's IP address inside the Docker container. Defaults to 0.0.0.0.
  • port: The API server's serving port inside the Docker container. Defaults to 9380.

• mysql

  • name: The MySQL database name. Defaults to rag_flow.
  • user: The username for MySQL.
  • password: The password for MySQL. When updated, you must revise the MYSQL_PASSWORD variable in .env accordingly.
  • port: The MySQL serving port inside the Docker container. Defaults to 3306.
  • max_connections: The maximum number of concurrent connections to the MySQL database. Defaults to 100.
  • stale_timeout: Timeout in seconds.

• minio

  • user: The username for MinIO. When updated, you must revise the MINIO_USER variable in .env accordingly.
  • password: The password for MinIO. When updated, you must revise the MINIO_PASSWORD variable in .env accordingly.
  • host: The MinIO serving IP and port inside the Docker container. Defaults to minio:9000.

• user_default_llm
  The default LLM to use for a new RAGFlow user. It is disabled by default. To enable this feature, uncomment the corresponding lines in service_conf.yaml.

  Tip

  If you do not set the default LLM here, configure the default LLM on the Settings page in the RAGFlow UI.

  • factory: The LLM supplier. Available options:
    • "OpenAI"
    • "DeepSeek"
    • "Moonshot"
    • "Tongyi-Qianwen"
    • "VolcEngine"
    • "ZHIPU-AI"
  • api_key: The API key for the specified LLM. You will need to apply for your model API key online.

• oauth
  The OAuth configuration for signing up or signing in to RAGFlow using a third-party account. It is disabled by default. To enable this feature, uncomment the corresponding lines in service_conf.yaml.

  • github: The GitHub authentication settings for your application. Visit the Github Developer Settings page to obtain your client_id and secret_key.