Paperless-ngx Document Management and Backup

Paperless-ngx Document Management and Backup#

This note documents the Paperless-ngx deployment on HP1Docker (10.1.2.202), its document locations, and the file-level backup path to HP1TrueNAS (10.1.2.201). It reflects the live configuration inspected on 2026-09-14.

1. Service architecture#

Paperless-ngx runs from /home/marc/docker-compose/paperless on HP1Docker using Docker Compose:

Service Role
paperless Paperless-ngx webserver, consumer, OCR workflow, and API
paperless_postgres18 PostgreSQL metadata database
paperless_broker Redis task/message broker
paperless_tika Text and document content extraction
paperless_gotenberg Office/document conversion and rendering
paperless-gpt Optional AI-assisted OCR/classification through Ollama on 10.1.2.231

The Compose definition is stored at: