---
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)

Drugi adapter dokumentów filaru KB #2 (moduł 4, `docs/kb/modules/04-nextcloud.md`):
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).

