# RagFlow

RagFlow is an open-source retrieval-augmented generation engine that combines deep document understanding with large language models to let self-hosters build private Q&A systems from PDFs, Word files, Markdown notes,. It is open source and self-hosted, installable on ZimaOS.

Canonical page: https://ourlocalhost.com/app/3824/ragflow

## Description

RagFlow is an open-source retrieval-augmented generation engine that combines deep document understanding with large language models to let self-hosters build private Q&A systems from PDFs, Word files, Markdown notes, and other documents.

## Platform availability

Available on 1 of 10 platforms: ZimaOS.

## Health score

73/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 15 days ago)
- Popular: 99 (93,778 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- GitHub: https://github.com/infiniflow/ragflow
- ZimaOS: https://github.com/IceWhaleTech/CasaOS-AppStore/tree/main/Apps/RagFlow
- Official website: https://ragflow.io

## Common questions

### Welche Hintergrunddienste müssen vor dem Start von RagFlow laufen?

Starte zuerst MinIO, Elasticsearch, Redis und MySQL mit dem mitgelieferten Docker-Compose-Befehl. Ohne diese Container kann RagFlow Dateien nicht speichern, Dokumente nicht indizieren und seine Konfiguration nicht halten.

### Warum muss .env.example vor dem Start kopiert werden?

Erstelle aus .env.example die Datei .env, weil sie als lokale, private Konfiguration dient. Fehlt sie oder enthält sie falsche Werte, verwendet RagFlow möglicherweise Standardwerte, die nicht zu deinem Storage-, Netzwerk- oder API-Setup passen.

### Welches Port und welchen Schlüssel verwende ich für die RagFlow API?

Setze base_url auf deine Serveradresse mit Port 9380 und ersetze <YOUR_API_KEY> durch deinen echten API-Schlüssel. Ohne korrekten Schlüssel und Port verbinden API-Clients nicht oder werden abgelehnt.

### Was kann eine instabile RagFlow-Serverausführung verursachen?

Häufige Ursachen sind Ressourcenlecks oder Deadlocks im Backend, Netzwerkfehler bei Docker-/Host-Netzwerk oder anhaltende Redis-Verbindungsprobleme. Wenn ein Backend-Prozess hängt, aber nicht beendet wird, startet das Startskript es nicht automatisch neu.

---
Source: Our Local Host (https://ourlocalhost.com/app/3824/ragflow), the self-hosted and open-source app directory.
