Back to articles
AI & Cloud

Guide to Deploy RAGFlow on Docker VPS: Enterprise RAG Platform with AI Layout-Aware Document Parsing

Detailed guide to deploy RAGFlow on Docker on a VPS for an enterprise-grade RAG platform with AI-powered layout-aware document parsing for text, images, and tables.

DPTCloud Engineering4 min read
Guide to Deploy RAGFlow on Docker VPS: Enterprise RAG Platform with AI Layout-Aware Document Parsing

Image credit: wikimedia

Introduction to RAGFlow and Enterprise RAG Platforms

RAGFlow is a powerful self-hosted Retrieval-Augmented Generation (RAG) platform designed to integrate AI into enterprise document processing workflows. With layout-aware document parsing capabilities, RAGFlow can analyze and extract content from complex documents such as PDFs, images, and tables—challenges that traditional RAG systems often struggle with.

Deploying RAGFlow on Docker within a Virtual Private Server (VPS) offers a secure, flexible, and self-hosted solution for businesses seeking full control over their AI processing pipelines. This setup enables organizations to build automated customer support systems, document management tools, or content analysis applications without relying on third-party cloud services.

Prerequisites for Deployment

Before deploying RAGFlow on Docker, ensure the following requirements are met:

  • A VPS with at least 8GB RAM and 2 vCPU (recommended 16GB RAM for larger scale).
  • Operating system: Ubuntu 20.04 or 22.04.
  • Docker and Docker Compose installed.
  • Stable internet connection to download Docker images.
  • SSH access to the VPS.

Deploying RAGFlow on Docker

We’ll use Docker Compose to deploy RAGFlow with essential services, including a database, document processing engine, and user interface.

Step 1: Create Project Directory and Configuration File

Create a project directory and the docker-compose.yml file:

mkdir ragflow-project && cd ragflow-project
touch docker-compose.yml

Step 2: Configure Docker Compose

Below is a sample docker-compose.yml file for deploying RAGFlow:

version: '3.8'

services:
  ragflow:
    image: ragflow/ragflow:latest
    container_name: ragflow
    ports:
      - "8080:8080"
    volumes:
      - ./data:/ragflow/data
      - ./logs:/ragflow/logs
    environment:
      - RAGFLOW_DB_HOST=ragflow_db
      - RAGFLOW_DB_PORT=5432
      - RAGFLOW_DB_USER=ragflow
      - RAGFLOW_DB_PASSWORD=ragflow123
      - RAGFLOW_DB_NAME=ragflow
    depends_on:
      - ragflow_db
    restart: unless-stopped

  ragflow_db:
    image: postgres:13
    container_name: ragflow_db
    environment:
      - POSTGRES_DB=ragflow
      - POSTGRES_USER=ragflow
      - POSTGRES_PASSWORD=ragflow123
    volumes:
      - ./db_data:/var/lib/postgresql/data
    restart: unless-stopped

Step 3: Start the Services

Run the following command to start RAGFlow:

docker-compose up -d

Verification and Post-Deployment Configuration

After deployment, verify the setup by accessing:

http://:8080

If the RAGFlow interface loads, the deployment was successful.

Post-Deployment Configuration

  • Log in to the admin interface and configure document directories for processing.
  • Integrate AI models such as Qwen, LLaMA, or OCR models like Tesseract for layout-aware document parsing.
  • Set up APIs to integrate with other enterprise applications.

AI-Powered Layout-Aware Document Parsing

RAGFlow integrates advanced AI models to process complex document layouts, including:

  • Image and text analysis in PDFs and images.
  • Table data extraction and column formatting based on layout.
  • Contextual content understanding, even in non-standard documents.

This enables businesses to automate internal document processing, reduce errors, and improve efficiency.

Troubleshooting and Validation

If you cannot access the interface, verify the following:

  • Run docker-compose ps to check container status.
  • Run docker logs ragflow to view error logs.
  • Ensure port 8080 is not blocked by the firewall.
  • Confirm Docker and Docker Compose are correctly installed.

References

DPTCloud Tier III Infrastructure

High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478