From 54e1c81cc6d22f43e2b958008beb933806cd2870 Mon Sep 17 00:00:00 2001
From: Paccoco <99041736+Paccoco@users.noreply.github.com>
Date: Wed, 6 May 2026 10:59:20 -0500
Subject: [PATCH] feat: add paperless-ngx document management stack

---
 documents/.env.example        |  4 ++++
 documents/docker-compose.yaml | 38 +++++++++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)
 create mode 100644 documents/.env.example
 create mode 100644 documents/docker-compose.yaml

diff --git a/documents/.env.example b/documents/.env.example
new file mode 100644
index 0000000..dfb6984
--- /dev/null
+++ b/documents/.env.example
@@ -0,0 +1,4 @@
+PAPERLESS_DBUSER=paperless
+PAPERLESS_DBPASS=changeme
+PAPERLESS_SECRET_KEY=generate_with_openssl_rand_hex_32
+PAPERLESS_REDIS=redis://:URL_ENCODED_REDIS_PASSWORD@shared-redis:6379
diff --git a/documents/docker-compose.yaml b/documents/docker-compose.yaml
new file mode 100644
index 0000000..da885cc
--- /dev/null
+++ b/documents/docker-compose.yaml
@@ -0,0 +1,38 @@
+name: documents
+
+services:
+  paperless:
+    image: ghcr.io/paperless-ngx/paperless-ngx:latest
+    container_name: paperless
+    restart: unless-stopped
+    ports:
+      - "8083:8000"
+    volumes:
+      - /mnt/docker-ssd/docker/appdata/paperless:/usr/src/paperless/data
+      - /mnt/unraid/data/paperless/media:/usr/src/paperless/media
+      - /mnt/unraid/data/paperless/export:/usr/src/paperless/export
+      - /mnt/unraid/data/paperless/consume:/usr/src/paperless/consume
+    env_file: .env
+    environment:
+      - PAPERLESS_REDIS=${PAPERLESS_REDIS}
+      - PAPERLESS_DBHOST=shared-postgres
+      - PAPERLESS_DBNAME=paperless
+      - PAPERLESS_DBPORT=5432
+      - PAPERLESS_TIME_ZONE=America/Chicago
+      - PAPERLESS_OCR_LANGUAGE=eng
+      - PAPERLESS_URL=https://paperless.paccoco.com
+    healthcheck:
+      test: ["CMD-SHELL", "curl -sf http://127.0.0.1:8000/ || exit 1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 60s
+    networks:
+      - ix-databases_shared-databases
+      - pangolin
+
+networks:
+  ix-databases_shared-databases:
+    external: true
+  pangolin:
+    external: true