« RAGFlow » : différence entre les versions

← Modification précédente Modification suivante →

Version du 6 juillet 2026 à 11:26

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

On lance le conteneur :

# cd /opt/ragflow/docker
# 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

@@ Ligne 1 : / Ligne 1 : @@
 == Installation ==
+{{Méta bandeau
+  | niveau = grave
+  | icône = important
+  | texte  =
+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 <code>ulimits.memlock</code>. L’erreur associée est généralement : <code>error setting rlimit type 8: operation not permitted</code>.
+}}
+{{Méta bandeau
+  | niveau = modéré
+  | icône = important
+  | texte  =
+Pour contourner ce problème dans un environnement de test ou homelab léger, il est généralement possible de commenter le bloc <code>ulimits.memlock</code> dans le fichier <code>docker-compose-base.yml</code>. 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.
+}}
+{{Méta bandeau
+  | niveau = information
+  | icône = loupe
+  | texte  =
+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|Docker]]
 * On installe git si nécessaire (exemple avec Debian) :
@@ Ligne 9 : / Ligne 28 : @@
 * On lance le conteneur :
   # cd /opt/ragflow/docker
+ # 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 :
+ <font color = grey>...</font>
+     <font color = blue>#</font>ulimits:
+       <font color = blue>#</font>memlock:
+         <font color = blue>#</font>soft: -1
+         <font color = blue>#</font>hard: -1
+ <font color = grey>...</font>
+On lance le conteneur :
   # docker compose -f docker-compose.yml up -d