Aktualizace
./backup.sh # 1) záloha — viz níž, proč vždycky
git pull # 2) nový kód (nebo nový ZIP — viz níž)
docker compose up -d --build # 3) přestavět a spustitDatabázové migrace se pustí automaticky při startu. Vaše .env, docker-compose.override.yml a pb_data aktualizace nepřepisuje.
Před aktualizací: záloha
Migrace jdou jen dopředu. Když se chcete vrátit na starší verzi, jediná cesta je obnovit zálohu z doby před aktualizací — PocketBase neumí migrace vracet (server běží s --automigrate=0). ./backup.sh před git pull trvá pár sekund; viz Záloha a obnova.
Vždycky --build
Aplikace i celá serverová logika jsou zapečené v image. Po jakékoli změně — nový kód, nebo proměnná v .env jako TZ — potřebujete:
docker compose up -d --builddocker compose restart vám bez varování dál pustí starý build.
Aktualizace ze ZIP (bez Gitu)
Když jste kód stáhli jako ZIP (postup pro Windows v Instalaci):
- Stáhněte nový ZIP ze stránky vydání a rozbalte ho vedle staré složky.
- Do nové složky zkopírujte ze staré jen tři věci:
pb_data(data),.env(konfigurace) adocker-compose.override.yml, pokud ho máte. - V nové složce
docker compose up -d --build. Starou složku smažte, až se nová osvědčí.
Všechno ostatní (docker-compose.yml, backup.sh, kód) patří k verzi a přepisuje se.
Po aktualizaci zkontrolujte
docker compose ps # služba „Up“
docker compose logs killbottleneck # na konci řádek „Server started“Migrace běží tiše — v logu je vidí jen ty, které něco přepočítávají (např. číslování projektů). Neúspěšná migrace naopak start zastaví: služba se restartuje dokola a v logu je chyba. V takovém případě obnovte zálohu a napište nám (Discord nebo hlášení chyb) — nespouštějte starý image nad novými daty.
V aplikaci pak menu u jména → O aplikaci ukáže novou verzi. Tamtéž se dozvíte o další: řádek Je dostupná verze … vede na poznámky k vydání.
Označení verze a kontrola nových verzí
Verzi předejte při buildu, ať instance ví, co jí běží:
KB_VERSION=$(git describe --tags --dirty) docker compose up -d --buildBez toho se instance hlásí jako dev a kontrola nových verzí se nenabízí — což je přesně to, co chcete u rozdělané práce.
Samotná kontrola běží v prohlížeči přihlášeného uživatele, který se zeptá GitHub API, jestli existuje novější vydání. Instance nikam nic neposílá, žádná telemetrie.
Předběžná vydání (-rc) jen na přání — KB_UPDATE_PRERELEASE=1
Kontrola ve výchozím stavu nabízí jen stabilní vydání (v1.0.0 a novější). Kdo chce vědět i o kandidátech vydání (v1.x.0-rc1), nastaví KB_UPDATE_PRERELEASE=1. Kontrolu vypíná KB_UPDATE_CHECK=0 (a KB_HOSTED=1 automaticky); vlastní fork čte z KB_UPDATE_REPO. Kdo ještě jede na v0.xx-beta, dostane nabídku v1.0.0 normálně.
Co se mezi verzemi mění
Každé vydání má v CHANGELOGu odstavec Upgrade notes. Většinou zní „no configuration changes“. Kdy stojí za to ho přečíst dřív, než pustíte --build:
| Vydání | Co vás po aktualizaci čeká |
|---|---|
| v0.87 | Nové proměnné KB_NAVRAT_* (návratové e-maily, vyžadují SMTP; vypnout KB_NAVRAT_MAILY=0). Předměty e-mailů začínají názvem organizace. |
| v0.86 | Migrace polí klientů a fakturace (faktury z asistenta) — bez zásahu. |
| v0.84 | Uzly nesou nepovinné pole icon v REST API i MCP. |
| v0.83 | Migrace přidá sdílené kalendáře; návrat na starší verzi je smaže. Nová instance dostane kalendáře Firemní a Nepřítomnosti (vypíná KB_UVODNI_MAPA=0). |
| v0.79 | Každý stávající uživatel uvidí jednou dialog Připoj svého AI agenta. KB_AGENT_SETUP_ASK=0 ho vypne — dodávaný docker-compose.yml ale tuhle proměnnou zatím nepředává, takže patří do docker-compose.override.yml (viz reference). |
| v0.68 | Výchozí KB_CHAT_TOOLS je auto (dřív groups); dialogy Navrhnout s AI a Mapa z textu nahradil asistent. |
| v0.65 | Kdo má vlastní compose/override, doplní KB_PURPOSE_ASK, KB_AI_OPENAI_EXTRA, KB_CHAT_TOOLS, KB_VISION_ZALOHA_NUM_CTX. |
| v0.63 | Migrace událostí a připomínek — návrat je smaže. |
| v0.61 | Kolekce asistenta (ai_chats, ai_memory, ai_chat_log), proměnné KB_VISION_*, KB_SHARE_INVITE_*. |
Pravidlo, které z tabulky plyne: migrace, která něco přidá, se při návratu na starší verzi smaže i s daty — proto záloha před aktualizací.
Návrat na starší verzi
docker compose stopgit checkout v0.86-beta(nebo rozbalit starší ZIP)./backup.sh restore kb-backup-….tgzze zálohy pořízené před aktualizacídocker compose up -d --build
Bez zálohy z doby před aktualizací starší verze nad novými daty nenaběhne správně.
Jednorázově: přechod z v0.11 a starších
Po přejmenování produktu se kontejner jmenuje killbottleneck místo flowmap. Starý kontejner pořád drží port 8090, takže nový by nenaskočil. Nejdřív ho odstraňte:
docker rm -f flowmap
docker compose up -d --buildData máte ve složce ./pb_data na disku, ne v kontejneru — o nic nepřijdete. Proměnné FLOWMAP_* ve vašem .env fungují dál, není potřeba je přepisovat.
Souvisí
- Záloha a obnova
- Proměnné prostředí → Aktualizace a verzování
- Instalace — proč vždy
--build, kde co leží

