{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "infiniflow-ragflow--self-host-a-chat-with-your-documents-engine",
 "repo": "infiniflow/ragflow",
 "repo_url": "https://github.com/infiniflow/ragflow",
 "repo_slug": "infiniflow-ragflow",
 "title": "Self-host a chat-with-your-documents engine",
 "page_title": "How to self-host a chat-with-your-documents engine with Ragflow",
 "summary": "Start RAGFlow with Docker Compose, connect your models and ask questions over your own files.",
 "who": "A small team that wants a private knowledge assistant over policies, manuals and reports.",
 "problem": "Hosted RAG tools mean uploading internal documents to someone else, and building your own pipeline takes weeks.",
 "outcome": "A RAGFlow web UI on your own server where you upload documents and get answers with citations.",
 "steps": [
  "Clone the repo with `git clone https://github.com/infiniflow/ragflow.git` and enter the folder with `cd ragflow/docker`",
  "Check out the release tag with `git checkout v1.0.0-rc3`",
  "Start the services with `docker compose -f docker-compose.yml up -d`",
  "Confirm it is ready with `curl -f http://localhost/api/v1/system/healthz`, and check logs with `docker logs --tail 50 ragflow-cpu` if it is not",
  "Open the server IP in a browser, sign in, and add an LLM, embedding model and reranker on the model provider page"
 ],
 "agent_prompt": "Deploy infiniflow/ragflow on this server with Docker Compose at tag v1.0.0-rc3, wait until the healthz endpoint returns 200, and tell me the URL to open. List what I still need to configure on the model provider page.",
 "agents": [
  "claude-code",
  "codex",
  "cursor"
 ],
 "difficulty": "Intermediate",
 "time": "1 hour",
 "basis": "readme",
 "caveat": "In the 1.0 open-source release DeepDoc uses CPU inference for layout, OCR and tables, so parsing large document sets takes time.",
 "category": "Research",
 "tags": [
  "Research"
 ],
 "lang": "go",
 "requirements": [
  "Docker 24.0.0 or later and Docker Compose v2.26.1 or later",
  "A starting machine of 4 CPU cores, 16 GB RAM and 50 GB free disk",
  "An LLM, an embedding model and a reranker, added with their service address and API key after sign-in",
  "If you use Elasticsearch, vm.max_map_count set to at least 262144"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "You paste model provider API keys into RAGFlow, so restrict access to the server and change default passwords in docker/.env before exposing it."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/infiniflow-ragflow/self-host-a-chat-with-your-documents-engine/",
 "md": "https://dedupedai.com/use-cases/infiniflow-ragflow/self-host-a-chat-with-your-documents-engine/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/infiniflow-ragflow--self-host-a-chat-with-your-documents-engine.json",
 "api_version": "v1"
}