{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/ragflow",
  "slug": "ragflow",
  "name": "RAGFlow",
  "tagline": "Retrieval-augmented generation engine that parses documents and answers questions about them.",
  "replaces": {
    "summary": "Paid enterprise search and knowledge assistant services, such as Glean.",
    "products": [
      {
        "slug": "glean",
        "name": "Glean",
        "vendor": "Glean",
        "url": "https://openlogs.fyi/alternatives/glean"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "Apache-2.0",
    "class": "osi",
    "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "1 service, 3 volume mounts, 6 env values to set, no elevated host access. Heuristic score 3 of 11: medium. The file includes other files, so counts may be low. A source checkout is needed, so the rating is at least medium."
  },
  "repository": {
    "owner": "infiniflow",
    "name": "ragflow",
    "url": "https://github.com/infiniflow/ragflow"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker/docker-compose.yml",
    "source_repo": "infiniflow/ragflow",
    "source_commit_sha": "4fd8c439af2cf31e19731675e27bbb9ccb854bf1",
    "source_kind": "app_repo",
    "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/docker/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin and git",
      "body": "A host with Docker, the Docker Compose plugin and git. This entry needs a checkout of the project repository.",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "shell",
      "language": "bash",
      "label": "Get the source at commit 4fd8c43",
      "body": "git init ragflow\ncd ragflow\ngit remote add origin https://github.com/infiniflow/ragflow.git\ngit sparse-checkout init --cone\ngit sparse-checkout set docker\ngit fetch --depth 1 --filter=blob:none origin 4fd8c439af2cf31e19731675e27bbb9ccb854bf1\ngit checkout FETCH_HEAD",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 3,
      "kind": "shell",
      "language": "bash",
      "label": "Go to the folder the docs use",
      "body": "cd docker",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "compose",
      "language": "yaml",
      "label": "The compose file in the checkout: docker/docker-compose.yml (shown here for reading)",
      "body": "include:\n  - ./docker-compose-base.yml\n# To ensure that the container processes the locally modified `service_conf.yaml.template` instead of the one included in its image, you need to mount the local `service_conf.yaml.template` to the container.\nservices:\n\n  ragflow-cpu:\n    depends_on:\n      mysql:\n        condition: service_healthy\n        required: false\n    profiles:\n      - cpu\n    image: ${RAGFLOW_IMAGE}\n    ulimits:\n      nofile:\n        soft: 65535\n        hard: 65535\n      nproc:\n        soft: 65535\n        hard: 65535\n    # MCP is served in-process by the API server (POST /mcp on the 9380 port).\n\n    # Example configuration to start Admin server:\n    command:\n      - --enable-adminserver\n      - --init-superuser\n      #- --init-model-provider-tables\n    ports:\n      - ${SVR_WEB_HTTP_PORT}:80\n      - ${SVR_WEB_HTTPS_PORT}:443\n      - ${SVR_HTTP_PORT}:9380\n      - ${ADMIN_SVR_HTTP_PORT}:9381\n    volumes:\n      - ./ragflow-logs:/ragflow/logs\n      # - ./nginx/ragflow.conf:/etc/nginx/conf.d/ragflow.conf\n      # - ./nginx/proxy.conf:/etc/nginx/proxy.conf\n      # - ./nginx/nginx.conf:/etc/nginx/nginx.conf\n      - ./service_conf.yaml.template:/ragflow/conf/service_conf.yaml.template\n      - ./entrypoint.sh:/ragflow/entrypoint.sh\n      # - ${RAGFLOW_SSH_KNOWN_HOSTS:-${HOME}/.ssh/known_hosts}:${SSH_KNOWN_HOSTS:-/etc/ragflow/ssh_known_hosts}:ro\n    env_file: .env\n    # Route the Go services' cache/queue backend to the separate Kvrocks service.\n    # The Python services use the Valkey `redis` service, which the Go deployment\n    # disables (see the `redis` profile override above). KVROCKS_HOST/KVROCKS_PORT\n    # are the IN-NETWORK coordinates the Go process uses to reach `kvrocks:6379`; the\n    # host-published port is KVROCKS_PORT (see docker-compose-base.yml), which CI\n    # offsets per job and keeps distinct from REDIS_PORT.\n    environment:\n      - KVROCKS_HOST=kvrocks\n      - KVROCKS_PORT=6379\n    networks:\n      - ragflow\n    restart: unless-stopped\n    # https://docs.docker.com/engine/daemon/prometheus/#create-a-prometheus-configuration\n    # If you use Docker Desktop, the --add-host flag is optional. This flag ensures that the host's internal IP is exposed to the Prometheus container.\n    extra_hosts:\n      - \"host.docker.internal:host-gateway\"\n\n",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/docker/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 5,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran in a checkout of infiniflow/ragflow at 4fd8c439af2cf31e19731675e27bbb9ccb854bf1 (a sparse checkout: the top-level files and the folder docker), in the folder docker. The README tells the reader to clone the repository, go into the docker folder and run docker compose up.",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 7,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:80. The compose file publishes host port 80 for the ragflow-cpu service. The README tells the reader to enter the IP address of the server in a browser and log in.",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/docker/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "The compose file includes other files",
      "body": "It reads more services from ./docker-compose-base.yml. Those files are not part of this entry, so the compose file does not run on its own.",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./ragflow-logs at /ragflow/logs (ragflow-cpu), ./service_conf.yaml.template at /ragflow/conf/service_conf.yaml.template (ragflow-cpu), ./entrypoint.sh at /ragflow/entrypoint.sh (ragflow-cpu).",
      "source_url": "https://github.com/infiniflow/ragflow/blob/4fd8c439af2cf31e19731675e27bbb9ccb854bf1/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 92649,
    "forks": 11069,
    "open_issues": 1317,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v1.0.0-rc2",
    "latest_release_date": "2026-10-16",
    "days_since_release": 6
  },
  "links": {
    "html": "https://openlogs.fyi/tools/ragflow",
    "markdown": "https://openlogs.fyi/tools/ragflow.md",
    "json": "https://openlogs.fyi/tools/ragflow.json"
  },
  "updated_at": "2026-10-22"
}