Skip to content

Aktualizace ​

bash
./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 spustit

Databá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:

bash
docker compose up -d --build

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

  1. Stáhněte nový ZIP ze stránky vydání a rozbalte ho vedle staré složky.
  2. Do nové složky zkopírujte ze staré jen tři věci: pb_data (data), .env (konfigurace) a docker-compose.override.yml, pokud ho máte.
  3. 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 ​

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

O aplikaci — tady vidíte, co běží, a jestli existuje novější vydání.

Označení verze a kontrola nových verzí ​

Verzi předejte při buildu, ať instance ví, co jí běží:

bash
KB_VERSION=$(git describe --tags --dirty) docker compose up -d --build

Bez 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.87Nové 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.86Migrace polí klientů a fakturace (faktury z asistenta) — bez zásahu.
v0.84Uzly nesou nepovinné pole icon v REST API i MCP.
v0.83Migrace 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.79Kaž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.68Výchozí KB_CHAT_TOOLS je auto (dřív groups); dialogy Navrhnout s AI a Mapa z textu nahradil asistent.
v0.65Kdo má vlastní compose/override, doplní KB_PURPOSE_ASK, KB_AI_OPENAI_EXTRA, KB_CHAT_TOOLS, KB_VISION_ZALOHA_NUM_CTX.
v0.63Migrace událostí a připomínek — návrat je smaže.
v0.61Kolekce 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í.

  1. docker compose stop
  2. git checkout v0.86-beta (nebo rozbalit starší ZIP)
  3. ./backup.sh restore kb-backup-….tgz ze zálohy pořízené před aktualizací
  4. 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:

bash
docker rm -f flowmap
docker compose up -d --build

Data 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í ​

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