Skip to content

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

bash
git clone https://github.com/tengolabs/killbottleneck.git
cd killbottleneck
cp .env.example .env    # volitelné — výchozí hodnoty stačí
docker compose up -d --build

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

Čistá instance se pozná podle titulku — kdo se zaregistruje první, je správce.

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

  1. 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.
  2. 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).
  3. Dva úvodní projekty — prohlídka aplikace a zkušební projekt, na kterém si zkusíte odškrtnout první krok.
Dotazník účelu se ptá jen jednou, prvního správce. Vypíná ho KB_PURPOSE_ASK=0.

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ěží ​

bash
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 200
Takhle vypadá zdravý start. Odkaz na konci logu je pro administraci PocketBase (SMTP) — do běžné práce ji nepotřebujete.

Kde 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í mapuPrvní mapa
Dát to na doménu s HTTPSHTTPS a reverzní proxy
Zapnout AI a asistentaKonfigurace → AI
Přihlašování přes GoogleKonfigurace → Přihlášení přes Google
Posílat pozvánky e-mailemKonfigurace → E-mail
Ovládat to z kóduREST API
Připojit AI asistentaMCP server

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