blumeops/docs/reference/infrastructure
Erich Blume 07f52e9488
All checks were successful
Build Container / detect (push) Successful in 2s
Build Container / build-dockerfile (paperless) (push) Successful in 9s
Deploy Paperless-ngx document management (#328)
## Summary

- Add paperless-ngx (v2.20.13) as a new ArgoCD-managed service on indri
- Dockerfile built from forge mirror (`mirrors/paperless-ngx`), multi-stage with s6-overlay
- PostgreSQL database via `blumeops-pg` CNPG cluster, Redis sidecar for Celery
- NFS document storage on sifaka (`/volume1/paperless`)
- Authentik OIDC SSO via baked JSON blob from 1Password
- Caddy route at `paperless.ops.eblu.me`
- 1Password item "Paperless (blumeops)" created with all secrets

## Files

- `containers/paperless/Dockerfile` — multi-stage build
- `argocd/manifests/paperless/` — full k8s manifest set
- `argocd/apps/paperless.yaml` — ArgoCD application
- `argocd/manifests/databases/` — CNPG role + ExternalSecret
- `ansible/roles/caddy/defaults/main.yml` — Caddy route
- `service-versions.yaml` — version tracking entry
- `docs/reference/services/paperless.md` — reference card

## Remaining deploy steps

1. Build container: `mise run container-build-and-release paperless`
2. Update kustomization.yaml `newTag` with actual image tag
3. Create Authentik application/provider for paperless
4. Create `paperless` database on blumeops-pg
5. Sync ArgoCD apps, then sync paperless from branch
6. Provision Caddy: `mise run provision-indri -- --tags caddy`
7. Verify at https://paperless.ops.eblu.me

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: #328
2026-04-08 17:54:12 -07:00
..
gandi.md Review gandi-operations doc and reorganize how-to guides (#200) 2026-02-17 07:29:33 -08:00
gilbert.md Add last-updated subsort to docs-review, review gilbert card 2026-03-17 13:22:01 -07:00
hosts.md Polish ringtail NixOS config and add documentation (#208) 2026-02-18 17:53:47 -08:00
indri.md Remove unused Mosquitto MQTT broker from ringtail 2026-03-11 18:37:31 -07:00
power.md Review power.md: add ringtail, mark reviewed 2026-03-18 07:37:31 -07:00
ringtail.md Pin NixOS service versions via nixpkgs-services overlay (#321) 2026-04-01 21:37:57 -07:00
routing.md Deploy Paperless-ngx document management (#328) 2026-04-08 17:54:12 -07:00
tailscale.md Review and correct Tailscale reference doc 2026-03-22 18:18:45 -07:00
unifi.md Add UnPoller for UniFi network metrics (#298) 2026-03-16 15:52:45 -07:00