Paperless-ngx

Document management system for organizing and searching scanned documents. Docs: docs.paperless-ngx.com

• URL: tailnet only — see Tailnet-only apps
• Port: internal (Caddy proxy)
• Data: /opt/paperless/data, /opt/paperless/media

Deploy

auberge deploy paperless

Bare-metal (no Docker). Requires Tailscale deployed first.

Required config

Key	Purpose
paperless_secret_key	Django secret key
paperless_admin_user	Admin username
paperless_admin_password	Admin password
paperless_db_password	PostgreSQL password
paperless_subdomain	Subdomain for HTTPS access
paperless_tailscale_ip	Tailnet address Blocky publishes for Paperless

Notes

Caution

auberge backup create --apps paperless backs up data and media directories only. The PostgreSQL database is not included — see #105.

Tip

A version bump is an outage. The four paperless-* units are stopped before the release swap and started after manage.py migrate, so nothing serves for the length of the install — minutes, most of it the venv rebuild. A failed install leaves them stopped: fix the cause and re-run auberge deploy paperless.