apiVersion: v1 kind: Namespace metadata: name: paperless --- # 1. THE AUTOMATED CNPG POSTGRES CLUSTER apiVersion: postgresql.cnpg.io/v1 kind: Cluster metadata: name: paperless-db namespace: paperless spec: instances: 1 # True 3-node HA across your mini-PCs! - edit down to 1, 3 overkill imageName: ghcr.io/cloudnative-pg/postgresql:16.4 storage: size: 15Gi storageClass: longhorn bootstrap: initdb: database: paperless_prod owner: paperless_admin #affinity: # enablePodAntiAffinity: true # topologyKey: "kubernetes.io/hostname" --- # 2. THE SIMPLE INDEPENDENT VALKEY CACHE apiVersion: apps/v1 kind: Deployment metadata: name: paperless-valkey namespace: paperless spec: replicas: 1 selector: matchLabels: app: paperless-valkey template: metadata: labels: app: paperless-valkey spec: containers: - name: valkey image: valkey/valkey:8.0-alpine args: ["--maxmemory", "256mb", "--maxmemory-policy", "allkeys-lru"] ports: - containerPort: 6379 --- apiVersion: v1 kind: Service metadata: name: paperless-valkey-svc namespace: paperless spec: ports: - port: 6379 selector: app: paperless-valkey --- # 3. THE PAPERLESS APPLICATION STORAGE apiVersion: v1 kind: PersistentVolumeClaim metadata: name: paperless-data-pvc namespace: paperless spec: accessModes: - ReadWriteOnce storageClassName: longhorn resources: requests: storage: 30Gi --- # 4. THE PAPERLESS APPLICATION CORE apiVersion: apps/v1 kind: Deployment metadata: name: paperless-ngx namespace: paperless spec: replicas: 1 selector: matchLabels: app: paperless-ngx template: metadata: labels: app: paperless-ngx spec: containers: - name: paperless image: ghcr.io/paperless-ngx/paperless-ngx:2.14 ports: - containerPort: 8000 env: - name: PAPERLESS_REDIS value: "redis://paperless-valkey-svc:6379" - name: PAPERLESS_DBENGINE value: "postgresql" - name: PAPERLESS_DBHOST value: "paperless-db-rw" # Automatically routes to the active HA primary pod - name: PAPERLESS_DBPORT value: "5432" - name: PAPERLESS_DBNAME value: "paperless_prod" - name: PAPERLESS_DBUSER value: "paperless_admin" - name: PAPERLESS_DBPASS valueFrom: secretKeyRef: name: paperless-db-app # Automatically created by CNPG using cluster name key: password # 👇 FIXES START HERE 👇 - name: PAPERLESS_URL value: "https://paper.needlestack.boo" # Must match your sub-domain exactly (no trailing slash) - name: PAPERLESS_ALLOWED_HOSTS value: "paper.needlestack.boo" # Add this to let Django trust the incoming Host header - name: PAPERLESS_CSRF_TRUSTED_ORIGINS value: "https://paper.needlestack.boo" # Must match the full HTTPS URL # 👇 INJECT THIS RAW DJANGO OVERRIDE 👇 - name: DJANGO_CSRF_TRUSTED_ORIGINS value: "https://paper.needlestack.boo" # 👇 ADD THESE TWO ENTRIES 👇 - name: PAPERLESS_TRUSTED_PROXIES value: "10.42.0.0/16,10.43.0.0/16" # Trusts the internal k3s pod/service CIDR blocks - name: PAPERLESS_TIME_ZONE value: "Europe/London" # 👇 ADD THESE THREE TO ENABLE OFFICE INGESTION 👇 - name: PAPERLESS_TIKA_ENABLED value: "true" - name: PAPERLESS_TIKA_ENDPOINT value: "http://paperless-tika-svc:9998" - name: PAPERLESS_TIKA_GOTENBERG_ENDPOINT value: "http://paperless-gotenberg-svc:3000" volumeMounts: - name: paperless-storage mountPath: /usr/src/paperless/data volumes: - name: paperless-storage persistentVolumeClaim: claimName: paperless-data-pvc --- apiVersion: v1 kind: Service metadata: name: paperless-svc namespace: paperless spec: ports: - port: 8000 selector: app: paperless-ngx --- # 5. THE INGRESS NETWORK ROUTING apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: paperless-ingress namespace: paperless annotations: cert-manager.io/cluster-issuer: "letsencrypt-production" nginx.ingress.kubernetes.io/backend-protocol: "HTTP" # 👇 ADD THESE THREE FOR CSRF / PROXY ALIGNMENT 👇 nginx.ingress.kubernetes.io/proxy-body-size: "50m" # Essential later for uploading large PDFs! nginx.ingress.kubernetes.io/ssl-redirect: "true" # 👈 This handles forcing HTTPS routing safely # 👇 ADD THESE TWO WEBSOCKET TIMEOUT/UPGRADE ANNOTATIONS 👇 nginx.ingress.kubernetes.io/proxy-read-timeout: "3600" nginx.ingress.kubernetes.io/proxy-send-timeout: "3600" spec: ingressClassName: nginx tls: - secretName: paperless-tls-secret hosts: - paper.needlestack.boo rules: - host: paper.needlestack.boo http: paths: - path: / pathType: Prefix backend: service: name: paperless-svc port: number: 8000 --- # 6. GOTENBERG (OFFICE CONVERSION ENGINE) apiVersion: apps/v1 kind: Deployment metadata: name: paperless-gotenberg namespace: paperless spec: replicas: 1 selector: matchLabels: app: paperless-gotenberg template: metadata: labels: app: paperless-gotenberg spec: containers: - name: gotenberg image: gotenberg/gotenberg:8.15.0 # Check for latest tag if preferred ports: - containerPort: 3000 # 👇 ADD THIS ENV BLOCK TO EXTEND TIMEOUT TO 120 SECONDS 👇 env: - name: GOTENBERG_API_TIMEOUT value: "120s" --- apiVersion: v1 kind: Service metadata: name: paperless-gotenberg-svc namespace: paperless spec: ports: - port: 3000 selector: app: paperless-gotenberg --- # 7. APACHE TIKA (METADATA TEXT EXTRACTION) apiVersion: apps/v1 kind: Deployment metadata: name: paperless-tika namespace: paperless spec: replicas: 1 selector: matchLabels: app: paperless-tika template: metadata: labels: app: paperless-tika spec: containers: - name: tika image: apache/tika:3.0.0.0-full # The "-full" variant contains the proper bindings ports: - containerPort: 9998 --- apiVersion: v1 kind: Service metadata: name: paperless-tika-svc namespace: paperless spec: ports: - port: 9998 selector: app: paperless-tika