Skip to content

Instalace ​

Tahle stránka je „pořádně, na serveru“ verze Rychlého startu.

Co potřebujete ​

  • Docker s pluginem Compose. Nic víc — žádný Node.js, žádný databázový server, žádný webserver. Image si sám sestaví frontend a přibalí PocketBase, který z jednoho kontejneru obsluhuje API, databázi, přihlašování i statické soubory.
  • Procesor x86-64. Image stahuje PocketBase pro linux/amd64; na ARM (Raspberry Pi, Mac s Apple silicon bez emulace, ARM servery v cloudu) build selže. Docker Desktop na Macu s Apple silicon to obvykle zvládne přes emulaci (pomaleji), pro ostrý provoz volte x86-64.
  • Pár set megabajtů místa na disku pro image plus to, co zaberou přílohy.
  • Ideálně stroj, který je zapnutý. Opakující se šablony, ranní souhrny, upozornění na termíny a připomínky s časem pohánějí cron úlohy uvnitř kontejneru. Nic se potichu nevynechá — když byl server v cílovou hodinu vypnutý, úlohy se dohoní později týž den — ale stroj zapnutý po ránu je doručí v hodinách, které jste nastavili. Po restartu stroje kontejner naběhne sám (restart: unless-stopped).

Ještě nemáte Docker? Vyberte si systém ​

Zbytek stránky je společný pro všechny — tahle část jen dovede vaše konkrétní zařízení do bodu, kdy funguje příkaz docker compose.

Windows 10 / 11 — krok za krokem
  1. Stáhněte si Docker Desktop z docker.com a nainstalujte ho. Instalátor si sám doplní WSL 2 a jednou vás vyzve k restartu — nechte ho restartovat.
  2. Spusťte Docker Desktop a počkejte, až vlevo dole zezelená Engine running. Dokud svítí oranžová, příkazy níže hlásí, že Docker neběží.
  3. Stáhněte si kód: na stránce projektu zelené tlačítko Code → Download ZIP a rozbalte ho třeba do C:\killbottleneck. (Máte-li Git, můžete místo toho použít git clone.)
  4. V Průzkumníku otevřete tu složku, klikněte do adresního řádku, napište powershell a stiskněte Enter. Otevře se příkazová řádka rovnou ve správné složce.
  5. Zkopírujte nastavení a spusťte:
    powershell
    Copy-Item .env.example .env
    docker compose up -d --build
  6. Otevřete v prohlížeči http://localhost:8090 a založte si účet správce.

Na co si dát pozor na Windows:

  • Když počítač uspíte nebo vypnete, instance spí s ním. Ranní souhrny a upozornění na termíny se pak doženou později týž den. Pro tým je lepší nechat běžet stroj, který je zapnutý pořád.
  • Chcete se připojit z mobilu nebo od kolegy? Použijte IP adresu počítače (ipconfig) místo localhost a při první výzvě povolte Dockeru průchod firewallem Windows pro soukromou síť.
  • Když je port 8090 obsazený, přepište v souboru .env řádek KB_PORT.
  • Aktualizace ze ZIP (bez Gitu) popisuje Aktualizace → Ze ZIP.
Linux (Ubuntu, Debian) — krok za krokem
  1. Nainstalujte Docker oficiálním skriptem a přidejte se do skupiny docker, ať nemusíte psát sudo u každého příkazu:
    bash
    curl -fsSL https://get.docker.com | sudo sh
    sudo usermod -aG docker $USER
    Po druhém příkazu se odhlaste a přihlaste (nebo restartujte) — jinak nová skupina ještě neplatí a Docker bude hlásit permission denied.
  2. Ověřte, že to jede:
    bash
    docker run --rm hello-world
  3. Dál pokračujte podle Stažení kódu níže. Nic dalšího instalovat nemusíte — Node.js ani databázi si image sestaví sám.
macOS

Stáhněte Docker Desktop pro Mac (pozor na správnou variantu — Apple silicon × Intel), spusťte ho a pak pokračujte podle Stažení kódu níže. Platí totéž co pro Windows: uspaný Mac znamená uspanou instanci. Na Apple silicon se image sestavuje přes emulaci x86-64 — funguje to, ale pomaleji.

Stažení kódu ​

bash
git clone https://github.com/tengolabs/killbottleneck.git
cd killbottleneck

Nastavení ​

bash
cp .env.example .env

Výchozí hodnoty fungují tak, jak jsou. Před prvním startem stojí za pohled tyhle:

ProměnnáProč teď
KB_PORTKdyž už něco jiného zabírá 8090.
TZNastavte své pásmo (např. Europe/Prague), jinak cron úlohy i připomínky s časem jedou v UTC.
KB_SETUP_CODENastavte, pokud je stroj dostupný z internetu — jinak se zaregistruje kdokoli, kdo zná adresu.
KB_NAMENázev kontejneru. Jiný název = druhá instance vedle první na témže stroji (spolu s jiným KB_PORT).
KB_PUBLIC_URLPotřeba pro automatizace (aby agent věděl, kam se ohlásit zpět) a za reverzní proxy pro OAuth AI agentů — viz HTTPS.

Úplný seznam je v Proměnných prostředí.

Spuštění ​

bash
docker compose up -d --build

První build trvá pár minut (sestavuje se frontend). Potom:

bash
docker compose ps
docker compose logs -f killbottleneck
Zdravý start: služba „Up“, v logu řádek „Server started“. Odkaz na konci je pro administraci PocketBase (viz níž).

Otevřete http://IP-SERVERU:8090 — čistá instance vás rovnou přivítá založením účtu správce (titulek Založte svou instanci, první účet se jím stane automaticky). Co následuje po prvním přihlášení, popisuje Rychlý start.

Označení verze ​

Bez něj se instance hlásí jako dev a dialog O aplikaci (menu u jména) nenabízí kontrolu nových verzí. Pro ostrý provoz:

bash
KB_VERSION=$(git describe --tags --dirty) docker compose up -d --build
Menu u jména → O aplikaci: tady instance říká, jakou verzi běží, a nabídne novější, když existuje.

Vždycky přestavět, nikdy jen restartovat ​

Aplikace i celá serverová logika jsou zapečené v image. Po jakékoli změně — novém kódu i proměnné v .env jako TZ — použijte:

bash
docker compose up -d --build

docker compose restart vám potichu nechá běžet starý build. Naráží na to dost lidí na to, aby se to vyplatilo zopakovat.

Kde co leží ​

CestaCo to je
./pb_dataDatabáze SQLite a nahrané soubory. Jediné, co musíte zálohovat.
./docker-compose.ymlDefinice služby. Aktualizace ji přepisují — needitujte ji.
./docker-compose.override.ymlVaše doplňky (reverzní proxy, další porty, proměnné, které compose nepředává). Aktualizace ho nepřepisují.
./.envVaše konfigurace. Aktualizace ji nepřepisují.
./backup.shPřiložený skript na zálohu a obnovu.

Když přejmenujete službu v compose

docker-compose.override.yml se na službu odkazuje jménem. Když přejmenujete službu v docker-compose.yml a na override nesáhnete, spadne docker compose config a sestava vůbec nenaskočí.

Administrace PocketBase ​

Instance vystavuje i superuživatelské rozhraní PocketBase na http://IP-SERVERU:8090/_/. Účet superuživatele založíte odkazem z docker compose logs (viz snímek výš), nebo příkazem docker compose exec killbottleneck /app/pocketbase superuser upsert EMAIL HESLO. Potřebujete ho přesně na dvě věci: nastavení SMTP a nahlížení do databáze. Běžná správa se dělá přímo v aplikaci (Správa organizace).

V administraci PocketBase neměňte kolekce

Schéma databáze se mění jen verzovanými migracemi v image (server běží s --automigrate=0). Když v administraci přidáte pole nebo kolekci ručně, po příštím --build změna zmizí, ale v evidenci migrací zůstane záznam, který zablokuje aplikaci dalších migrací. Data si prohlížejte, strukturu nechte na aktualizacích.

Dál ​

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