Záloha a obnova
Všechna data leží v jedné složce: ./pb_data vedle docker-compose.yml — databáze SQLite a nahrané soubory. Nic vašeho není nikde jinde a nic není uvnitř kontejneru.
Přiložený skript
./backup.sh # vytvoří kb-backup-RRRR-MM-DD.tgz
./backup.sh restore SOUBOR # obnoví data ze zálohySkript rozumí i staršímu českému tvaru ./backup.sh obnovit SOUBOR.
Co skript dělá a stránka to dřív neříkala:
- Zálohuje za běhu — kontejner nezastavuje. Databázi vezme jako konzistentní snímek (
sqlite3 .backupuvnitř kontejneru: jeden okamžik, žádné půlky write-ahead logu), nahrané soubory přibalí vedle. Starší verze skriptu kopírovala surové soubory databáze běžící instance, což pod zátěží umělo dát archiv s tiše rozbitým indexem; pokud takové starší archivy máte,restoreje teď kontroluje (níže). Jediné, co v archivu může chybět, je příloha nahrávaná přesně v té vteřině — příští běh ji má. - Soubor zálohy dostane práva
600(čte jen vlastník) a nešifrovaný archiv vypíše varování the archive is NOT encrypted. - Obnova archiv nejdřív prověří (odmítne cesty mimo
pb_data/), rozbalí ho vedle, nad rozbalenou databází spustíPRAGMA integrity_checkpřessqlite3z obrazu instance (poškozený archiv odmítne a živá data nechá, jak jsou), teprve pak zastaví instanci, prohodí složky a instanci zase spustí. Stará data zůstanou vpb_data.old— až si obnovu zkontrolujete, smažte ji (rm -rf pb_data.old).
Šifrovaná záloha
Archiv nese úplně všechno — mapy, uživatelské účty i nahrané soubory. Jakmile má opustit server (stažení na notebook, kopie mimo dům, jakýkoli cloud), zašifrujte ho: nastavte KB_BACKUP_PASSPHRASE a skript místo toho vytvoří kb-backup-RRRR-MM-DD.tgz.gpg (symetrické GPG, AES-256).
export KB_BACKUP_PASSPHRASE='dlouhe-heslo-ktere-znate-jen-vy'
./backup.sh # → kb-backup-RRRR-MM-DD.tgz.gpg
./backup.sh restore kb-backup-....tgz.gpg # stejné heslo, jinak se gpg zeptárestore bere obojí — prosté .tgz i .tgz.gpg — takže starší nešifrované zálohy fungují dál. Heslo držte mimo server i mimo repozitář, ideálně ve správci hesel. Žádná záchrana neexistuje: bez hesla je archiv nečitelný pro všechny, včetně vás.
Pravidelně a mimo stroj
Záloha, která leží na témže disku jako data, přežije smazaný kontejner, ale ne vadný disk. Jednou za den skript z cronu a kopie jinam:
# crontab -e (uživatel, který má práva na složku s instancí)
0 3 * * * cd /cesta/ke/killbottleneck && KB_BACKUP_PASSPHRASE='…' ./backup.sh >> backup.log 2>&1Soubory kb-backup-*.tgz.gpg pak odvezte kamkoli mimo stroj — rsync na NAS, rclone do cloudu, nebo ruční stažení jednou týdně. Staré zálohy skript nemaže; uklízejte je sami (ls kb-backup-*).
Ručně
Zálohujete zkopírováním složky pb_data, obnovujete jejím vrácením zpět. Opravdu v tom nic víc není.
docker compose stop
tar czf kb-backup-$(date +%F).tgz pb_data
docker compose startPřed větší aktualizací si zálohu udělejte
Databázové migrace se pouštějí automaticky při startu a jdou jen dopředu — návrat na starší verzi znamená obnovit zálohu. Záloha pořízená před docker compose up -d --build je rozdíl mezi blbým odpolednem a blbým týdnem.
Zálohu ověřte, nespoléhejte na ni
Záloha, kterou jste nikdy neobnovili, je hypotéza. Jednou si ji nanečisto rozbalte:
mkdir /tmp/kb-restore-test && cd /tmp/kb-restore-test
tar xzf /cesta/k/kb-backup-2026-10-24.tgz
ls pb_data # měli byste vidět data.db a složku storage se souboryOstrá zkouška je obnovit ji do druhé instance (KB_NAME + KB_PORT jiný, vlastní složka) a přihlásit se.
Co v záloze NENÍ
.env a docker-compose.override.yml jsou konfigurace, ne data — skript je nepřikládá. Uložte si je taky; bez nich naskočí obnovená instance s výchozími porty, bez AI a bez přihlášení přes Google. Nastavení SMTP leží v databázi (pb_data), to v záloze je.
Export jednotlivce není záloha instance
Můj účet → Moje data stáhne JSON s mapami a nastavením jednoho člověka — hodí se na přenos vlastních projektů, ne jako záloha serveru. Viz Export a import.
Souvisí
- Aktualizace — kdy zálohu určitě chcete
- Instalace → Kde co leží
- Export a import — exporty z aplikace

