Implementation:Infiniflow Ragflow Docker Prerequisites Check

Knowledge Sources	RAGFlow Docker Docs
Domains	DevOps, Infrastructure
Last Updated	2026-02-12 06:00 GMT

Overview

External tool documentation for verifying system prerequisites before RAGFlow deployment.

Description

System-level commands to verify and configure host prerequisites for RAGFlow. The most critical check is vm.max_map_count which must be >= 262144 for Elasticsearch to function correctly.

Usage

Run these commands on the deployment host before starting Docker containers.

Code Reference

Source Location

• Repository: ragflow
• File: README.md (L145-178)

Signature

# Check current vm.max_map_count
sysctl vm.max_map_count

# Set temporarily
sudo sysctl -w vm.max_map_count=262144

# Set permanently
echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# Verify Docker version
docker --version    # >= 24.0.0
docker compose version  # >= v2.26.1

Import

# System commands - no import needed

I/O Contract

Inputs

Name	Type	Required	Description
Host system	Linux	Yes	Target deployment host
sudo access	bool	Yes	Required for sysctl changes

Outputs

Name	Type	Description
vm.max_map_count	int	Should be >= 262144
Docker version	string	Should be >= 24.0.0

Usage Examples

# Full prerequisite check script
#!/bin/bash
echo "=== Checking Prerequisites ==="

# vm.max_map_count
MAP_COUNT=$(sysctl -n vm.max_map_count)
if [ "$MAP_COUNT" -lt 262144 ]; then
    echo "FAIL: vm.max_map_count=$MAP_COUNT (need >= 262144)"
    sudo sysctl -w vm.max_map_count=262144
else
    echo "OK: vm.max_map_count=$MAP_COUNT"
fi

# Docker
docker --version && echo "OK: Docker installed" || echo "FAIL: Docker not found"
docker compose version && echo "OK: Docker Compose installed" || echo "FAIL: Docker Compose not found"

# Resources
echo "CPU cores: $(nproc)"
echo "RAM: $(free -h | grep Mem | awk '{print $2}')"
echo "Disk: $(df -h / | tail -1 | awk '{print $4}') available"

Related Pages

Implements Principle

• Principle:Infiniflow_Ragflow_Deployment_Prerequisites
• Environment:Infiniflow_Ragflow_Docker_Infrastructure