homelab-updaterandClaude Opus 5.5
dbb17ea5b9
Auto stays at patch: on 0.x every minor migrates the database one way. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.4 KiB
Trilium — VM103
Usługa trilium, obraz triliumnext/trilium — TriliumNext, utrzymywany fork zadam/trilium (oryginał w trybie utrzymania). Domena trilium.mariuszpacek.pl (także notes.mariuszpacek.pl), port 8080 tylko w sieci proxy, bez portu na hoście. Whitelist traefika jak w bazarr (LAN, VPN, 172.16.0.1/32 dla drivera). Aplikacja ma własne logowanie hasłem.
Dane: /home/node/trilium-data ← /srv/appdata/trilium/data (document.db SQLite, config.ini, backup/, log/), właściciel 1000:1000, tryb 700. Entrypoint startuje jako root, robi chown -R node:node /home/node i uruchamia serwer jako node (uid 1000) — nie ustawiaj user: w compose.
Obraz ma healthcheck (/api/health-check) i etykietę OCI org.opencontainers.image.version z tagiem.
Źródła: wydania, dokumentacja, Docker.
Wersje: tagi vX.Y.Z (bez -rc, main, sha-*, latest). Seria 0.x: każdy minor to wydanie z nowymi funkcjami i zwykle z jednokierunkową migracją bazy — stąd auto patch, a minor czeka na decyzję właściciela.
Migracja bazy przy starcie w jednej transakcji; przed nią Trilium sam zapisuje backup/backup-before-migration.db. Historia: 2026-09-30 baza przeniesiona z /fast-vm/docker/trilium/mariusz na Proxmoksie (Trilium 0.60, dbVersion 214) i zmigrowana na v0.106.0 (dbVersion 240); kopia sprzed tej migracji: backup/backup-before-migration-v060.db.
Kopia: codzienny vzdump VM103 obejmuje /srv/appdata; workflow kopiuje compose przed zmianą. Dodatkowa kopia bazy nie jest wymagana, bo Trilium robi ją sam przed migracją.
Odbiór: kontener healthy na przypiętym obrazie; /api/health-check przez HTTPS → 200; w logu Migration to version N has been successful (jeśli była migracja) i All consistency checks passed; brak Error przy starcie. Treść notatek sprawdza właściciel po zalogowaniu.
STOP: log pokazuje nieudaną migrację (migration failed, crash przy starcie) albo błędy spójności bazy — nie naprawiaj bazy, opisz i zostaw decyzję właścicielowi.
Powrót: rollback przywraca compose sprzed aktualizacji, ale starsza wersja odmówi otwarcia bazy po migracji. Wtedy trzeba przy zatrzymanym kontenerze przywrócić document.db z backup/backup-before-migration.db (albo z vzdumpu) — tylko za zgodą właściciela.