RAGFlow

Installation

Avertissement : l’installation de RAGFlow via Docker dans un conteneur LXC Proxmox peut échouer à cause de certaines limites système définies dans le fichier Docker Compose, notamment le réglage ulimits.memlock. L’erreur associée est généralement : error setting rlimit type 8: operation not permitted.

Pour contourner ce problème dans un environnement de test ou homelab léger, il est généralement possible de commenter le bloc ulimits.memlock dans le fichier docker-compose-base.yml. Cette modification peut réduire certaines optimisations liées au verrouillage de la mémoire, notamment pour les services de recherche ou d’indexation comme Elasticsearch, OpenSearch ou Infinity. L’impact reste généralement limité si la machine dispose de suffisamment de RAM et n’utilise pas ou peu le swap.

Pour une installation plus stable et durable, il est recommandé d’installer RAGFlow dans une machine virtuelle Debian dédiée plutôt que dans un Docker imbriqué dans un conteneur LXC.

On utilise Docker

• On installe git si nécessaire (exemple avec Debian) :

# apt update && apt upgrade
# apt install git

• On récupère le projet :

# cd /opt/
# git clone https://github.com/infiniflow/ragflow.git
# cd /opt/ragflow/docker

• On édite la configuration si nécessaire :

 # vi .env

• On lance le conteneur :

# docker compose -f docker-compose.yml up -d

Suppression du bloc ulimits pour usage via LXC

# cd /opt/ragflow/docker/
# vi docker-compose-base.yml

Commenter le bloc suivant :

...
    #ulimits:
      #memlock:
        #soft: -1
        #hard: -1
...

On lance le conteneur :

# docker compose -f docker-compose.yml up -d

Configuration

Supprimer l’enregistrement des utilisateurs

# vi /opt/ragflow/docker/.env

...
REGISTER_ENABLED=0
...

On relance les conteneurs :

# cd /opt/ragflow/docker/
# docker compose -f docker-compose.yml up -d

Première connexion

Il faut se rendre sur l'adresse http://IP_SERVEUR avec l'identifiant administrateur par défaut :

admin@ragflow.io
admin

Il est recommandé de changer le mot de passe administrateur après la première connexion.