Skip to content

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 ​

bash
./backup.sh                 # vytvoří kb-backup-RRRR-MM-DD.tgz
./backup.sh restore SOUBOR  # obnoví data ze zálohy

Skript rozumí i staršímu českému tvaru ./backup.sh obnovit SOUBOR.

Záloha a obnova skriptem — co uvidíte. Obnova instanci na pár sekund zastaví.

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 .backup uvnitř 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, restore je 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_check přes sqlite3 z 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 v pb_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).

bash
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:

bash
# 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>&1

Soubory 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í.

bash
docker compose stop
tar czf kb-backup-$(date +%F).tgz pb_data
docker compose start

Př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:

bash
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 soubory

Ostrá 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í ​

Open source pod licencí MIT · © Tengo s.r.o.