Storage & Productivity

Self-Hosting Paperless-ngx on a VPS (2026): OCR CPU/RAM & Docker Setup

Paperless-ngx idles around 900 MB with PostgreSQL + Redis, but Tesseract OCR spikes to 2.5–3.5 GB when batch-scanning PDFs. KVM 1 (4 GB, ~$5.19/mo) works with 1 OCR worker; KVM 2 (8 GB, ~$7.03/mo with XF3PLUTARXVF) handles Office docs via Tika/Gotenberg smoothly.

Self-Hosting Paperless-ngx on a VPS (2026): OCR CPU/RAM & Docker Setup
RATE SHEET

Hardware Spec & Verified Rate Sheet: Paperless-ngx

November 22, 2026
Hardware Spec & Verified Rate Sheet: Paperless-ngx
Provider / TierHardware & ArchitectureListNet BenefitCodeLink
Hostinger KVM 2
Recommended for Paperless-ngx
2 vCPU AMD EPYC · 8 GB DDR5 · 100 GB NVMe · 8 TB$8.79/mo~$7.03/mo (-20%)Claim -20%
Proton (VPN & Privacy)
WireGuard + VPS Privacy
Gluetun WireGuard + NAT-PMP · Swiss No-Logs · Mail/Drive/PassSubscription$20 USD creditClaim $20
01 Open the link to bind XF3PLUTARXVF (-20%) or 5AA9X0DA ($20 USD).02 Pick 12/24-mo KVM VPS or Proton Plus/Unlimited.03 Deploy Ubuntu 24.04 + Docker + WireGuard tunnel.
01 / HARDWARE TELEMETRY

Measured RAM, vCPU & NVMe Profile for Paperless-ngx

Min → Rec RAM
4 GB → 8 GB
Idle 920 MB · Peak 3600 MB
Min → Rec vCPU
1 → 2 vCPU
AMD EPYC / High-Clock
Min → Rec NVMe
40 → 100 GB
PCIe Gen4 NVMe SSD
Primary Bottleneck

Tesseract OCR CPU/RAM bursts during multi-page PDF ingestion

Projected Memory Footprint on Hostinger KVM 2 (8 GB RAM)Idle 11% · Peak 44% · Headroom 56%
02 / DOCKER COMPOSE & SHELL

Production Deployment Stack (Paperless-ngx)

Docker Stack Sizer
docker-compose.ymlyaml
services:
  broker:
    image: docker.io/library/redis:7-alpine
    restart: unless-stopped

  db:
    image: docker.io/library/postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - db
      - broker
    ports:
      - "127.0.0.1:8010:8000"
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
      PAPERLESS_DBPASS: ${POSTGRES_PASSWORD}
      PAPERLESS_URL: https://docs.${BASE_DOMAIN}
      PAPERLESS_OCR_LANGUAGE: eng+spa
      PAPERLESS_TASK_WORKERS: 1
      PAPERLESS_THREADS_PER_WORKER: 2
      PAPERLESS_SECRET_KEY: ${PAPERLESS_SECRET_KEY}
    volumes:
      - data:/usr/src/paperless/data
      - media:/usr/src/paperless/media
      - ./consume:/usr/src/paperless/consume
    deploy:
      resources:
        limits:
          memory: 3G

volumes:
  pgdata:
  data:
  media:
deploy-and-verify.shbash
mkdir -p /opt/paperless/consume && cd /opt/paperless
printf "POSTGRES_PASSWORD=%s\nPAPERLESS_SECRET_KEY=%s\nBASE_DOMAIN=yourdomain.com\n" "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
docker compose up -d
docker compose exec webserver createsuperuser
03 / PRODUCTION FIELD NOTES

Critical Operational Insights

Always cap `PAPERLESS_TASK_WORKERS=1` on 2-vCPU VPS tiers so parallel OCR jobs don't thrash RAM.
04 / SECURITY & PRIVACY

UFW Firewall, TLS & WireGuard / ProtonVPN Hardening

Tax invoices and IDs are highly sensitive: put Paperless-ngx behind WireGuard/Headscale VPN or Caddy with MFA, and encrypt all off-site document backups.

Isolate container egress with ProtonVPN WireGuard + Proton Suite (US$20 in credits · code 5AA9X0DA).Claim US$20 on Proton
05 / VERIFIED DEPLOYMENT STACK

Deploy on Verified Infrastructure

KVM COMPUTE · EXTRA −20%

Hostinger KVM 2

~$7.03/mo
$8.79/mo
vCPU
2 EPYC
RAM
8 GB
NVMe
100 GB
24m Save
~$42
Renew: $12.99/mo · Free backups
SWISS PRIVACY · ACCOUNT CREDIT

Proton VPN & Unlimited

US$20
in credits
Tunnel
WireGuard
Docker
Gluetun + NAT
Suite
VPN·Mail·Drive
pr.tn/ref/5AA9X0DA

Frequently Asked Questions

Does Paperless-ngx support bilingual English + Spanish OCR?

Yes — set `PAPERLESS_OCR_LANGUAGE=eng+spa` and `PAPERLESS_OCR_LANGUAGES=spa` so Tesseract downloads Spanish traineddata automatically.

More blueprints in this category

All guides