2026-08-04 15:06:40 +02:00
|
|
|
---
|
|
|
|
|
okf: "0.1"
|
|
|
|
|
type: service
|
|
|
|
|
visibility: private
|
|
|
|
|
status: active
|
|
|
|
|
updated: 2026-07-09
|
|
|
|
|
links:
|
|
|
|
|
- ../decisions/nextcloud-host-piha.md
|
|
|
|
|
- ../runbooks/nextcloud-cutover.md
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Nextcloud (drive / WebDAV)
|
|
|
|
|
|
fix(kb): przepiecie wszystkich odwolan wewnetrznych po migracji
126 plikow (md, yaml, sh, py) odwolywalo sie do sciezek sprzed migracji.
15 markdown-linkow [..](..) -> policzona sciezka WZGLEDNA wobec pliku
odsylajacego (wczesniej czesc z nich byla repo-root-relative i nie
rozwiazywala sie z katalogu, w ktorym lezala)
200 odwolan tekstowych (backticki, proza, yaml, importy w kodzie)
-> nowa sciezka repo-root-relative, zgodnie z konwencja repo
5 linkow rodzenstwa (gole nazwy plikow, np. "](DEPLOY.md)") — dzialaly
tylko w starym katalogu; przeliczone recznie
Objete m.in.: CLAUDE.md (scripts/onboard/README.md -> kb/runbooks/
node-onboarding-tool.md, docs/backlog.md -> kb/phases/backlog.md),
README.md, .claude/skills/, 20 session logow, kod jobow.
Ostatnie 5 odwolan pochodzi z tresci wciagnietej rebasem z origin/master
(session log 2026-07-31, override node-agenta na SOLARII, dwie pozycje
backlogu) — wskazywaly na docs/incidents/, docs/kb/modules/ i
services/narty27/README.md sprzed migracji.
Dodany wzajemny link miedzy kb/services/control-plane.md (stub kodu)
a kb/subsystems/control-plane.md (opis, deprecated) — dwa dokumenty o tym
samym systemie, latwe do pomylenia.
Weryfikacja na 790 plikach: 0 odwolan do starych sciezek,
0 martwych linkow markdown. Lint OKF: 190/190 plikow ZGODNE.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 15:12:24 +02:00
|
|
|
Drugi adapter dokumentów filaru KB #2 (moduł 4, `kb/phases/kb-m4-nextcloud.md`):
|
2026-08-04 15:06:40 +02:00
|
|
|
zamiennik Google Drive — dowolne pliki + sync telefon/desktop, źródło dla
|
|
|
|
|
ingestu KB (moduł 5) przez WebDAV.
|
|
|
|
|
|
|
|
|
|
**Nextcloud = archiwum KOPIA w hybrydzie kb-02** — ingest robi snapshot pliku
|
|
|
|
|
do archiwum KB; Nextcloud NIE jest źródłem prawdy (inaczej niż Paperless).
|
|
|
|
|
Backup „warto" (dane użytkownika), ale nie jest warunkiem brzegowym KB.
|
|
|
|
|
|
|
|
|
|
## Stack
|
|
|
|
|
|
|
|
|
|
| Kontener | Obraz | Rola |
|
|
|
|
|
|------------------|-------------------------|---------------------------------------|
|
|
|
|
|
| `nextcloud` | `nextcloud:34-apache` | app + WebDAV (port 80 → host 8220 na LAN_BIND_IP) |
|
|
|
|
|
| `nextcloud-cron` | `nextcloud:34-apache` | joby w tle (`/cron.sh`, ten sam wolumen) |
|
|
|
|
|
| `nextcloud-db` | `postgres:16-alpine` | baza (bez portu na hoście) |
|
|
|
|
|
| `nextcloud-redis`| `redis:7-alpine` | cache + file locking (bez portu, bez persystencji) |
|
|
|
|
|
|
|
|
|
|
Wersja przypięta na `34-apache` (aktualny stable na 2026-07-09, wydany
|
|
|
|
|
2026-06-09 — zweryfikowane przez endoflife.date/nextcloud). Nextcloud
|
|
|
|
|
wydaje nowy major co ~4 miesiące i nie wspiera przeskakiwania wersji przy
|
|
|
|
|
upgrade — **TODO PRZY DEPLOYU**: potwierdzić bieżący stable tuż przed
|
|
|
|
|
`docker compose up` i podbić tag, jeśli wyszła nowsza wersja.
|
|
|
|
|
|
|
|
|
|
## WebDAV dla ingestu (moduł 5)
|
|
|
|
|
|
|
|
|
|
Endpoint: `https://cloud.kapala.org/remote.php/dav/files/<user>/`.
|
|
|
|
|
Konta OIDC nie mają hasła — dla ingestu wygenerować **app password**
|
|
|
|
|
(Settings → Security → Devices & sessions) i trzymać je w sekretach
|
|
|
|
|
adaptera ingest, nie w tym repo.
|
|
|
|
|
|
|
|
|
|
## Storage i backup
|
|
|
|
|
|
|
|
|
|
- `/opt/homelab/data/nextcloud/html` — aplikacja + config + **pliki
|
|
|
|
|
użytkowników** (`html/data/`)
|
|
|
|
|
- `/opt/homelab/data/nextcloud/db` — Postgres
|
|
|
|
|
|
|
|
|
|
TODO DECYZJA OSKARA: backup user-data (mniej krytyczny niż Paperless, bo
|
|
|
|
|
KB trzyma kopie zaingestowanych plików): propozycja — rsync/borg
|
|
|
|
|
`html/data` + `pg_dump` w tej samej nocnej pętli co backup Paperlessa,
|
|
|
|
|
retencja krótsza (np. 7 dziennych + 4 tygodniowe).
|
|
|
|
|
|