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
- 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.
- 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ěží.
- 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žítgit clone.) - V Průzkumníku otevřete tu složku, klikněte do adresního řádku, napište
powershella stiskněte Enter. Otevře se příkazová řádka rovnou ve správné složce. - Zkopírujte nastavení a spusťte:powershell
Copy-Item .env.example .env docker compose up -d --build - Otevřete v prohlížeči
http://localhost:8090a 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ístolocalhosta 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řádekKB_PORT. - Aktualizace ze ZIP (bez Gitu) popisuje Aktualizace → Ze ZIP.
Linux (Ubuntu, Debian) — krok za krokem
- Nainstalujte Docker oficiálním skriptem a přidejte se do skupiny
docker, ať nemusíte psátsudou každého příkazu:bashPo druhém příkazu se odhlaste a přihlaste (nebo restartujte) — jinak nová skupina ještě neplatí a Docker bude hlásitcurl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USERpermission denied. - Ověřte, že to jede:bash
docker run --rm hello-world - 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
git clone https://github.com/tengolabs/killbottleneck.git
cd killbottleneckNastavení
cp .env.example .envVýchozí hodnoty fungují tak, jak jsou. Před prvním startem stojí za pohled tyhle:
| Proměnná | Proč teď |
|---|---|
KB_PORT | Když už něco jiného zabírá 8090. |
TZ | Nastavte své pásmo (např. Europe/Prague), jinak cron úlohy i připomínky s časem jedou v UTC. |
KB_SETUP_CODE | Nastavte, pokud je stroj dostupný z internetu — jinak se zaregistruje kdokoli, kdo zná adresu. |
KB_NAME | Název kontejneru. Jiný název = druhá instance vedle první na témže stroji (spolu s jiným KB_PORT). |
KB_PUBLIC_URL | Potř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í
docker compose up -d --buildPrvní build trvá pár minut (sestavuje se frontend). Potom:
docker compose ps
docker compose logs -f killbottleneckOtevř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:
KB_VERSION=$(git describe --tags --dirty) docker compose up -d --buildVž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:
docker compose up -d --builddocker 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ží
| Cesta | Co to je |
|---|---|
./pb_data | Databáze SQLite a nahrané soubory. Jediné, co musíte zálohovat. |
./docker-compose.yml | Definice služby. Aktualizace ji přepisují — needitujte ji. |
./docker-compose.override.yml | Vaše doplňky (reverzní proxy, další porty, proměnné, které compose nepředává). Aktualizace ho nepřepisují. |
./.env | Vaše konfigurace. Aktualizace ji nepřepisují. |
./backup.sh | Př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
- Konfigurace — AI, přihlašování, e-mail, limity
- HTTPS a reverzní proxy — dostat se k tomu zvenčí
- Záloha a obnova — dřív než tam dáte skutečnou práci
- Aktualizace — jak přejít na novou verzi

