oskar/homelab-codex-ws
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
homelab-codex-ws/kb/phases/kb-m2-paperless.md
oskar 0858e25c81 feat(kb): przenosiny type=phase do kb/phases/ (14 plikow, bez SPLIT) 
Plany faz KB (modul 5 fazy 2/3/4/mailowa, moduly 0/2/3/4, documents-ingest,
raport fallback-dedup, eval retrieval-pilot) oraz prometheus-cutover-etap2,
subsystem-a-naprawa, okit-cloudflare.

git mv + frontmatter, tresc nietknieta.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 16:58:04 +02:00

2.3 KiB
Raw Blame History

okf type visibility status updated links
0.1 phase private active 2026-07-01

Modul 2 — Paperless-ngx serwis (na PIHA)

Serwis dokumentow: UI+API+Postgres+Redis. Always-on na PIHA. OCR-worker OSOBNO (modul 3). Zalezy od: 0 (odchudzic PIHA), 1 (SSO).

Cel

Postawic Paperless-ngx jako serwis GitOps na PIHA — bez ciezkiego OCR (ten na SOLARIA, modul 3). Serwis dostepny 24/7 dla zapytan KB + UI do przegladania.

Wymogi

  • services/paperless/ — docker-compose.yml + service.yaml (owner_node=piha).
  • Komponenty: paperless-webserver (UI+API), postgres, redis (broker kolejki OCR).
  • OIDC przez Forgejo (wzorzec z modulu 1). Login = konto Forgejo.
  • Ingress LAN-only przez npm@PIHA (NIE public/VPS). Subdomena np. paper.kapala.org lub paper.okit.pl -> A record na Tailscale/LAN, DNS Only.
  • Storage: media + oryginaly na PIHA NVMe (/home/docker lub dedykowany volume).
  • Backup (WARUNEK BRZEGOWY hybrydy — Paperless=referencja): storage backupowany. Zaprojektowac: gdzie (offsite? SOLARIA? drugi dysk?), retencja, jak (paperless document-exporter / rsync volume / borg?).
  • OCR w tym module WYLACZONY lub minimalny — ciezki batch idzie na worker (modul 3). Redis wystawiony tak, by worker na SOLARIA mogl sie podpiac (Tailscale).

Do zweryfikowania przez CC

  • Realne zuzycie RAM Paperless-serwis bez OCR na arm64 (czy miesci sie po odchudzeniu PIHA).
  • Porty — kolizje na PIHA (juz 40 kontenerow, sprawdzic wolne).
  • Paperless env: PAPERLESS_REDIS, PAPERLESS_DBHOST, PAPERLESS_OCR_* , PAPERLESS_URL, PAPERLESS_TASK_WORKERS / PAPERLESS_THREADS_PER_WORKER (pod split OCR).
  • OIDC w Paperless: PAPERLESS_APPS / python-social-auth / mozilla-django-oidc — ktory mechanizm, jak skonfigurowac przeciw Forgejo.
  • arm64 image dostepny (ghcr.io/paperless-ngx/paperless-ngx).
  • Jak Redis ma byc osiagalny dla worker@SOLARIA (bind Tailscale IP, nie tylko localhost).

Kryteria ukonczenia

  • Paperless UI dziala na PIHA, login przez Forgejo-OIDC.
  • Dostepny LAN/Tailscale, NIE z publicznego internetu.
  • Redis broker osiagalny dla zewnetrznego workera (modul 3).
  • Backup storage zaprojektowany i dzialajacy (nie "TODO").
  • W GitOps: services/paperless/ + wpis w hosts/piha/services.yaml + topology.
  • Deploy przez normalny flow (nie manualnie na hoscie).