Rychlý start
killBottleneck je zdarma u sebe, s API a MCP. Potřebujete jen Docker (s pluginem Compose) na stroji s procesorem x86-64. Není si kde zakládat cloudový účet a není se kde registrovat.
Spuštění
git clone https://github.com/tengolabs/killbottleneck.git
cd killbottleneck
cp .env.example .env # volitelné — výchozí hodnoty stačí
docker compose up -d --buildPrvní start trvá pár minut — sestavuje se frontend. killBottleneck pak běží na http://IP-SERVERU:8090; kolegové ve stejné síti si tu adresu jen otevřou v prohlížeči. Jediná hodnota, kterou stojí za to v .env nastavit hned, je TZ (např. Europe/Prague) — bez ní běží ranní souhrny a připomínky v UTC.
Příště vždycky s --build
Aplikace je zapečená v image. Po každé změně — nový kód i proměnná v .env — platí docker compose up -d --build; pouhý restart nechá běžet starý build. Viz Aktualizace.
Založení prvního účtu
Otevřete adresu a zaregistrujte se. Čistá instance to říká rovnou v titulku: Založte svou instanci — První účet se stane správcem. Ostatní se pak můžou zaregistrovat sami, nebo je správce pozve ze Správy organizace — pozvánka založí účet s dočasným heslem, které předáte.
Pokud je stroj dostupný z internetu
Registrace je ve výchozím stavu otevřená, takže účet si může založit kdokoli, kdo zná adresu. Než to vystavíte ven, nastavte v .env klíč KB_SETUP_CODE — každá registrace pak ten klíč vyžaduje.
Co uvidíte po prvním přihlášení
- K čemu budete killBottleneck používat? — Firma nebo tým, Rodina a přátelé, nebo Jen pro sebe. Podle odpovědi se připraví úvodní projekty a výchozí sdílené kalendáře Firemní a Nepřítomnosti.
- Připoj svého AI agenta — jeden řádek do Claude Code, Cursoru nebo Codexu. Kdo agenta nemá nebo neví, co to je, okno zavře velkým tlačítkem Zavřít; najdete ho kdykoli v menu u jména → Připojit AI agenta (viz MCP server).
- Dva úvodní projekty — prohlídka aplikace a zkušební projekt, na kterém si zkusíte odškrtnout první krok.
Všechny tři věci jde vypnout v .env (KB_PURPOSE_ASK, KB_AGENT_SETUP_ASK, KB_UVODNI_MAPA) — viz Proměnné prostředí → První přihlášení.
Kontrola, že to opravdu běží
docker compose ps # služba killbottleneck má být „running“
docker compose logs -f killbottleneck # startovací log včetně odkazu pro superuživatele
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8090 # čekáme 200Kde jsou data
Ve složce ./pb_data vedle docker-compose.yml — databáze SQLite a nahrané soubory. Leží na hostiteli, ne v kontejneru, takže přestavěním ani smazáním kontejneru o nic nepřijdete. Než se na to spolehnete, přečtěte si Zálohu a obnovu.
Co dál
| Nakreslit první mapu | První mapa |
| Dát to na doménu s HTTPS | HTTPS a reverzní proxy |
| Zapnout AI a asistenta | Konfigurace → AI |
| Přihlašování přes Google | Konfigurace → Přihlášení přes Google |
| Posílat pozvánky e-mailem | Konfigurace → E-mail |
| Ovládat to z kódu | REST API |
| Připojit AI asistenta | MCP server |

