Deploy guide

Private document management on Proxmox.

Proxmox makes it easy to give DocManFu its own isolated VM, with snapshots and backups handled at the hypervisor.

Why it fits

Why run DocManFu on Proxmox

  • Isolate your document archive from other services
  • Hypervisor snapshots before upgrades
  • Proxmox Backup Server can protect the whole VM

Before you install

Setup notes

  1. 1A small Linux VM with Docker Engine and Compose v2 is the simplest setup
  2. 2Allocate at least 2 GB of RAM, more if you run local AI
  3. 3Pass through a GPU if you want faster local Ollama models
  4. 4Snapshot the VM before upgrading DocManFu

What you get

The full DocManFu stack on Proxmox

DocManFu runs as one Docker Compose stack: web app, API, PostgreSQL, Redis, and a background OCR worker. Anywhere Docker Engine and Docker Compose v2 run, DocManFu can run. OCR happens locally, AI is optional and can run locally with Ollama, and your documents stay on storage you control.

git clone https://github.com/DocManFu/DocManFu.git
cd DocManFu
cp .env.production.example .env   # set POSTGRES_PASSWORD and JWT_SECRET_KEY
./prod up -d

Other ways to self-host

What will you store?

Your documents. Your rules.

Ready to master the paper pile?

One Docker Compose command puts a private, searchable document vault on hardware you control. Prefer not to self-host? A hosted version is coming soon—ask @DustinDavis on X.