Stirling-PDF: the PDF toolbox that lives on your NAS

Every household has a PDF workflow held together by sketchy free websites — upload a tax form here, a signed contract there, and hope. Stirling-PDF ends that: more than sixty PDF tools (merge, split, OCR, redact, sign, compress, convert) in one self-hosted container that processes everything locally. It is the #2 most-recommended app on r/selfhosted, ahead of Home Assistant itself — and it pairs with Paperless-ngx like they were designed together.

Published Nov 18, 2026

Deploy it

services:
  stirling-pdf:
    image: stirlingtools/stirling-pdf:latest
    container_name: stirling-pdf
    ports:
      - "8080:8080"
    volumes:
      - ./stirling/configs:/configs
      - ./stirling/customFiles:/customFiles
      - ./stirling/logs:/logs
    environment:
      - LANGS=en-US   # OCR + UI language
    restart: unless-stopped

That is genuinely the whole install — one container, no database, no account. Open it at your NAS's port 8080 (remap the host side if qBittorrent or a friend already owns 8080 — the Compose generator flags exactly that collision). First run walks you through optional login setup; for a LAN-only family tool many households skip accounts entirely and let the reverse proxy or Tailscale be the gate.

Deploy the container→First-run settings→OCR language packs→Wire into Paperless→Everyday workflows

The tools you will actually use

Pairing with Paperless-ngx

Paperless is the archive; Stirling is the workbench. The workflow that emerges: documents arrive (scanner, email, downloads), anything needing surgery — merging a two-part form, redacting an account number before sharing, OCR for a stubborn scan — goes through Stirling, and the finished document lands in Paperless's consume folder for tagging and permanent search. Our Paperless guide covers the archive side; keep both on the same NAS and the pair covers the entire paper life of a house. For tax season specifically, this duo is the whole system: gather in Paperless, prepare in Stirling, send with confidence.

Settings worth five minutes

Official documentation and references

Frequently asked questions

Is Stirling-PDF really private? My PDFs are sensitive.

Yes — processing happens in the container on your NAS; documents are not uploaded anywhere. That is the entire point versus free web tools, and why it suits tax forms, contracts and medical paperwork.

How is this different from Paperless-ngx?

Paperless archives and searches documents you keep. Stirling edits and transforms PDFs themselves. They are complements: Stirling is the workbench, Paperless is the filing cabinet — most households end up running both.

Does it need much hardware?

Very little for everyday tools. OCR of large batches is the only CPU-hungry job; a modern NAS handles it fine, just let big batches run rather than expecting instant results.

Related guides