Paperless homelab dependency recovery

Paperless-ngx, ScanservJS, Stirling PDF, and the shared document PVC declarations are now reconciled by Argo CD from homelab-gitops. Their portable charts live in separate Paperless, scanner, and PDF editor repositories. Do not apply old application manifests or deploy these workloads directly from CI.

This repository remains active temporarily for the existing PostgreSQL Helm release and Valkey deployment, which are not yet Argo-managed. ./install.sh only bootstraps their namespace/Secrets and reconciles these two dependencies; it does not write Argo-owned workloads or PVCs. It checks that the current Kubernetes context is kubernetes-admin@kubernetes before making changes. ./test.sh checks this recovery configuration without cluster writes.

The existing PostgreSQL PVC and its data require PostgreSQL 17; postgresql-values.yaml deliberately pins the 17.11-bookworm image. Do not remove that pin just because the chart's default has moved to PostgreSQL 18. Argo adoption of the existing PostgreSQL StatefulSet remains pending because the rendered chart would change immutable StatefulSet fields. Never delete/recreate the StatefulSet or claim as a shortcut; first establish tested backups and a safe adoption plan. Valkey currently holds only ephemeral cache state, but replacing its Deployment is still a distinct cutover and has not been done.

The retained PVCs are paperless-data, paperless-runtime, and postgres-data-postgresql-0. Back up all three and the paperless-secret-key and paperless-postgres Secrets together. setup-authentik.sh remains a manual recovery tool for the existing OIDC integration and paperless-oidc Secret; install.sh does not rerun it. No CI job in this repository has Kubernetes credentials after the Argo cutover.

For normal application or cluster configuration changes, edit the owning chart repository or the relevant GitOps values and allow Argo CD to reconcile them. Once PostgreSQL and Valkey are safely migrated, this repository can be archived after confirming no recovery-only content remains.

S
Description
No description provided
Readme GPL-3.0
179 KiB
0 Stars 1 Watchers 0 Forks
Languages
Python 60.5%
Shell 39.5%