Skip to content

Proměnné prostředí ​

Všechno se nastavuje v .env vedle docker-compose.yml. Zkopírujte šablonu a upravte:

bash
cp .env.example .env

Po každé změně přestavte — restart nestačí:

bash
docker compose up -d --build

Staré názvy FLOWMAP_* fungují dál

Proměnné se dřív jmenovaly FLOWMAP_*. Oběma názvům rozumí jak Docker Compose, tak server, takže .env ze starší verze funguje dál. Nové instalace ať používají KB_*.

Do kontejneru dojde jen to, co docker-compose.yml předává

Server čte i proměnné, které dodávaný docker-compose.yml nezná (dnes KB_AGENT_SETUP_ASK a KB_PRIVATE_WEBHOOK_HOSTS). Ty v .env nemají účinek — patří do docker-compose.override.yml, který aktualizace nepřepisují:

yaml
services:
  killbottleneck:
    environment:
      KB_AGENT_SETUP_ASK: "0"

Testovací a hostované přepínače (KB_TEST_CLOCK, KB_TRIAL_UNTIL, KB_MAX_USERS, KB_CUSTOMER…) tu záměrně nejsou: slouží našemu provozu a testům, na vlastním serveru je nenastavujte.

Základ ​

Jediné, co většina instalací mění: port a časové pásmo.

ProměnnáVýchozíCo dělá
KB_PORT8090Port, na kterém instance poslouchá: http://IP-SERVERU:PORT.
KB_NAMEkillbottleneckNázev kontejneru. Jiný název = druhá instance vedle první na témže stroji (dřív se dva stacky popraly o jméno).
TZUTCČasové pásmo instance. Určuje, v jakém pásmu se počítá „den“ a „hodina“ pro opakující se šablony, ranní souhrny, upozornění na termíny a připomínky s časem (události v kalendáři a připomínky k termínu chodí v HH:MM tohoto pásma — s výchozím UTC přijde připomínka „14:00“ v 16:00 letního času). Nastavte např. Europe/Prague. Platí pro celou instanci — tým rozprostřený přes pásma dostane pásmo serveru.
KB_AUTO_HOUR5Hodina (0–23, v TZ), od které opakující se šablony zakládají ten den projekty. Když byl server v tu hodinu vypnutý, založí se v nejbližší pozdější hodinu téhož dne.
KB_DEADLINE_HOUR7Hodina ranního souhrnu termínů (0–23, lokálně). Zároveň hodina, ve které přijde připomínka celodenní události v kalendáři.

AI ​

ProměnnáVýchozíCo dělá
KB_AI_PROVIDERnonenone = žádná AI (všechno ostatní funguje). openai = jakékoli OpenAI-kompatibilní API (OpenAI, OpenRouter, Groq, vLLM, LM Studio…). ollama = váš vlastní lokální model. api = vzdálená AI služba kompatibilní s killBottleneck API (adresa + token). custom = váš endpoint se stejným kontraktem.
KB_AI_URL(prázdné)Adresa endpointu. Pro ollama adresa Ollamy, např. http://192.168.1.10:11434. Pro openai základní adresa, obvykle končí /v1 — nalepené /chat/completions nebo chybějící /v1 se srovná samo.
KB_AI_TOKEN(prázdné)Token pro api / custom; u openai váš API klíč (posílá se jako Authorization: Bearer).
KB_AI_MODEL(prázdné)U ollama model, který se má použít (nejdřív ollama pull <model>); u openai přesný název modelu podle poskytovatele, např. gpt-4o-mini.
KB_AI_REASONING_BUDGET4000Jen openai, uvažující modely (řada o, gpt-5* vč. GPT-5.6 Luna): tokeny navíc k běžnému stropu jako místo na přemýšlení — bez nich model umí promyslet celý strop a nevrátit nic. Uvažující model se pozná podle jména, podle odmítnutého max_tokens/teploty nebo podle reasoning_tokens v odpovědi (pak si ho instance pamatuje). Platí pro asistenta, AI pomocníka, sumáře i čtení obrázků.
KB_AI_REASONING_EFFORTlowJen openai, uvažující modely: reasoning_effort do každého požadavku (minimal/low/medium/high podle toho, co model umí; auto = neposílat). Hodnota v KB_*_OPENAI_EXTRA má přednost; když model hodnotu odmítne (OpenAI spolu s voláním nástrojů bere jen none), volání se zopakuje s none a pak bez pole; co prošlo, si instance pro daný model pamatuje.
KB_AI_OPENAI_EXTRA(prázdné)Jen openai — JSON s poli navíc do každého požadavku, např. {"reasoning_effort":"none"} pro vypnutí uvažování tam, kde to poskytovatel dovolí (totéž co KB_CHAT_OPENAI_EXTRA, ale pro obecné AI funkce). platí i pro asistenta (pokud není KB_CHAT_OPENAI_EXTRA) a pro sumáře.
KB_AI_TRANSCRIBE_URL(prázdné)Endpoint pro přepis řeči. Když je prázdný, odvodí se z KB_AI_URL. U openai ho můžete nechat prázdný — hlasovky pak přepisuje tatáž služba; když ho vyplníte, platí tahle adresa.
KB_AI_TRANSCRIBE_MODELwhisper-1Jen pro openai — model přepisu (Groq: whisper-large-v3). Nastavit jde i ve Správě organizace → AI funkce.
KB_AI_MAX_PER_HOUR60Jen pro openai — kolik AI operací smí jeden člověk za hodinu. Každé volání utrácí váš kredit. AI asistent na boku má vlastní počítadlo se stejným stropem, které platí u každého poskytovatele. Nad strop: Vyčerpali jste hodinový strop AI operací (60).
KB_AI_MAX_TRANSCRIBE_PER_HOUR20Kolik přepisů smí jeden člověk za hodinu přes přepisovací mód API (/api/kb/advisor, mode: transcribe) — u každého poskytovatele. Hlasovky v asistentovi se počítají do KB_AI_MAX_PER_HOUR (viz KB_AI_HLAS_VAHA).

Totéž jde nastavit v aplikaci: Správa organizace → AI funkce (poskytovatel, adresa, model, token, přepis, obrázky). Uložení v aplikaci má přednost před .env.

KB_AI_PROVIDER, KB_AI_URL, KB_AI_MODEL a KB_AI_TOKEN v podobě formuláře — s tlačítkem Otestovat připojení.

Ranní souhrn ​

Jednořádkové povzbuzení v Mém dni může používat zvlášť menší model.

ProměnnáVýchozíCo dělá
KB_SUMMARY_HOUR6Hodina ranního generování (lokálně).
KB_SUMMARY_MINUTE—Minuta té hodiny (0–59); prázdné = stálá minuta 1–30 odvozená z adresy instance.
KB_SUMMARY_ACTIVE_DAYS14Ráno generovat jen účtům přihlášeným v posledních N dnech. 0 = všem. Neaktivním se vygeneruje, až si aplikaci otevřou.
KB_SUMMARY_PROVIDER(prázdné)Přebije KB_AI_PROVIDER jen pro souhrny.
KB_SUMMARY_URL(prázdné)Přebije KB_AI_URL jen pro souhrny.
KB_SUMMARY_MODEL(prázdné)Přebije KB_AI_MODEL jen pro souhrny.
KB_SUMMARY_TOKEN(prázdné)Přebije KB_AI_TOKEN jen pro souhrny.

Asistent na boku ​

AI asistent v panelu vpravo. Model hledá v pořadí KB_CHAT_* → KB_SUMMARY_* → obecné nastavení AI. Panel se ukáže jen s poskytovatelem ollama nebo openai a potřebuje model s voláním nástrojů (tool calling), např. gemma4, qwen3, gpt-oss nebo gpt-4o-mini.

ProměnnáVýchozíCo dělá
KB_CHAT_PROVIDER(prázdné)ollama nebo openai — vlastní model jen pro asistenta. Prázdné = použije se KB_SUMMARY_*, pak obecné nastavení AI.
KB_CHAT_URL(prázdné)Adresa modelu asistenta (jako KB_AI_URL).
KB_CHAT_MODEL(prázdné)Název modelu asistenta.
KB_CHAT_TOKEN(prázdné)API klíč pro model asistenta.
KB_CHAT_THINK(prázdné)Uvažování modelu: prázdné = vypnuto (nejrychlejší), jinak low, medium, high nebo true.
KB_CHAT_NUM_CTX(prázdné)Jen ollama — velikost kontextu (num_ctx) posílaná v každém volání. Ollama má jinak výchozích 4096 tokenů a delší prompt asistenta by tiše ořízla.
KB_CHAT_OPENAI_EXTRA(prázdné)Jen openai — JSON s poli navíc do požadavku, např. {"reasoning_effort":"none"}. Uvažující modely s nízkým limitem tokenů ho jinak můžou celý spotřebovat na přemýšlení a vrátit chybu, kterou poskytovatel stejně účtuje.
KB_CHAT_TOOLSautoKterá schémata nástrojů model asistenta dostane. auto = modely GPT (gpt-* kromě gpt-oss, o*, chatgpt*) dostanou všechny nástroje v každém volání — nenabídnutý nástroj nikdy nezavolají, takže funkce bez klíčového slova by tiše zmizela; ostatní modely jen skupiny, o které rozhovor stojí (šetří tokeny; nástroj, který si model stejně řekne, se přidá a volání zopakuje). groups = vždy jen skupiny. all = vždy všechny nástroje.
KB_AI_KVOTA_TYDEN(prázdné)Strop AI kreditů (tahů; 1 tah ≈ jedna běžná zpráva asistentovi) na týden pro organizaci — sekce AI kredity ve Správě organizace. Hodnota nastavená v aplikaci ho může jen snížit, ne zvednout. Prázdné = bez stropu provozovatele.
Kam KB_AI_KVOTA_TYDEN dopadá: sekce AI kredity ukazuje spotřebu po lidech a týdnech a vlastní kvótu organizace.

Obrázky v asistentovi ​

Obrázek nejdřív přepíše model, který obrázky vidí; pak se pracuje jen s textem. Originál se neukládá. Bez KB_VISION_PROVIDER, KB_VISION_URL a KB_VISION_MODEL asistent obrázky odmítá.

ProměnnáVýchozíCo dělá
KB_VISION_PROVIDER(prázdné)ollama nebo openai — model pro čtení obrázků (např. gemma4 / gemma3 přes Ollamu, nebo OpenAI-kompatibilní API s obrazovým vstupem).
KB_VISION_URL(prázdné)Adresa modelu pro obrázky.
KB_VISION_MODEL(prázdné)Název modelu pro obrázky.
KB_VISION_TOKEN(prázdné)API klíč pro model obrázků.
KB_VISION_NUM_CTX8192Jen ollama — velikost kontextu pro přepis obrázku.
KB_VISION_OPENAI_EXTRA(prázdné)Jen openai — JSON s poli navíc; u uvažujících modelů {"reasoning_effort":"none"}.
KB_VISION_ZALOHA_PROVIDER / _URL / _MODEL / _TOKEN / _NUM_CTX / _OPENAI_EXTRA(prázdné)Volitelný záložní model, když první selže nebo nestihne odpovědět.
KB_VISION_TIMEOUT45Sekund na jeden pokus o přepis. Celkový čas držte hluboko pod časovým limitem reverzní proxy (Cloudflare kolem 100 s).
KB_VISION_POKUSY0Kolikrát navíc zkusit první model, než přijde na řadu záloha.
KB_CHAT_MAX_IMG_MB1.2Největší přijatý obrázek v MB. Prohlížeč snímky obrazovky sám zmenšuje zhruba na 250 kB. Zvýšením roste strop těla požadavku asistenta (dnes ~4,25 MB) — za nginx zvedněte i client_max_body_size, viz HTTPS.
KB_CHAT_NAHLEDU3Kolik malých náhledů obrázků drží jeden rozhovor; u starších zůstane jen přepis.
KB_CHAT_POTVRZENIappKdo dopoví po potvrzení jednoduché karty (přidání/úprava kroku, sdílení, vzhled…): app = aplikace napíše „Hotovo.“ bez volání modelu, model = odpoví model jako dřív.
KB_CHAT_MAX_TAHU10Kolik posledních tahů rozhovoru dostává model (2–30). Jen pro měření.
KB_CHAT_MAX_TOOL_STARE600Na kolik znaků se modelu zkracují výsledky nástrojů ze starších tahů (200–12000). Jen pro měření.
KB_CHAT_STALY_ZACATEK(prázdné)1 = seznam map na začátku zadání zůstane po celý rozhovor stejný; mapy založené nebo přejmenované později dostane model jako poznámku v rozhovoru. Začátek zadání se mezi dotazy nemění, takže modely, jejichž server si pamatuje jen začátek (např. Strata), nemusí celé zadání číst znovu. Jiné modely to nepotřebují. KB_CHAT2_STALY_ZACATEK = totéž pro druhý model.
KB_CHAT_STALE_NASTROJE(prázdné)1 = seznam nástrojů pro model zůstane po celý rozhovor stejný; skupiny nástrojů otevřené později se popíšou v rozhovoru místo přidání do seznamu. Účel stejný jako KB_CHAT_STALY_ZACATEK. KB_CHAT2_STALE_NASTROJE = totéž pro druhý model.
KB_CHAT_HYBRID(prázdné)Dva modely v asistentovi: lehký (KB_CHAT_LIGHT_*) na čtení, porady a koncepty, hlavní na zápisy. Strategie oddělené čárkou: rezim = režimy porada/rozbor jdou lehkému modelu; klasifikator = lehký model nejdřív rozhodne „je to zápis?“ (jedno krátké volání); predani = lehký model začne a jakmile chce zapisovat, tah předá hlavnímu. Prázdné = jeden model.
KB_CHAT_LIGHT_PROVIDER / _URL / _MODEL / _TOKEN / _THINK / _NUM_CTX / _OPENAI_EXTRA(prázdné)Lehký model pro KB_CHAT_HYBRID (ollama nebo openai), význam stejný jako u KB_CHAT_*; _THINK má výchozí low. Bez poskytovatele hybrid neběží.
KB_AI_IMG_VAHA3Kolik tahů z hodinového stropu (KB_AI_MAX_PER_HOUR) ubere jeden tah s obrázkem.
KB_TRANSCRIBE_PROVIDER / _URL / _MODEL / _TOKEN(prázdné)Přepis řeči pro hlasovky v asistentovi v OpenAI tvaru (multipart /audio/transcriptions): speaches, whisper.cpp server, faster-whisper-server, OpenAI, Groq… KB_TRANSCRIBE_PROVIDER=openai + celá adresa (např. http://192.168.1.10:8000/v1/audio/transcriptions) a model (např. Systran/faster-whisper-large-v3). Prázdné = rozhodne obecná AI (služba openai, která nabízí model whisper/transcribe, KB_AI_TRANSCRIBE_URL, nebo brána). none = přepis vypnout.
KB_TRANSCRIBE_VAD(auto)Filtr ticha (vad_filter=true, speaches / faster-whisper). Výchozí zapnutý u vlastní KB_TRANSCRIBE_URL, pokud nemíří na OpenAI nebo Groq — bez něj si Whisper na tichu vymýšlí text (třeba adresu webu). 0 = vypnout, 1 = vždy (i pro KB_AI_TRANSCRIBE_URL).
KB_CHAT_HLAS_MAX_S300Nejdelší hlasovka namluvená v asistentovi v sekundách (tam prohlížeč nahrávání zastaví; přiložený zvukový soubor omezuje jen velikost).
KB_CHAT_MAX_AUDIO_MB3Největší přijatá nahrávka v MB (5 minut Opusu ≈ 1,2 MB).
KB_AI_HLAS_VAHA2Kolik tahů z hodinového stropu ubere jeden tah s hlasovkou (přepis + odpověď).
KB_AI_PDF_VAHA2Kolik tahů z hodinového stropu ubere jeden tah s přiloženým PDF (asistent dostane jen text stran; sloučení a rozdělení PDF běží v prohlížeči a nestojí nic).

Kreslení obrázků ​

Asistent kreslí ilustrace, bannery a obrázky do prezentací (viz Obrázky od asistenta). Bez nastavení je kreslení vypnuté a tlačítka se neukážou.

ProměnnáVýchozíCo dělá
KB_IMAGE_PROVIDER(prázdné)openai = vlastní služba se standardním OpenAI Images API (POST …/images/generations); api = AI služba killBottleneck z KB_AI_URL / KB_AI_TOKEN; none = vypnout.
KB_IMAGE_TOKEN(prázdné)API klíč služby obrázků. U openai povinný. Bez něj zůstane kreslení vypnuté.
KB_IMAGE_URL(prázdné)Základní adresa služby. U openai výchozí https://api.openai.com/v1.
KB_IMAGE_MODELgpt-image-1-miniJen openai: název modelu. Služba musí vrátit JPEG (modely gpt-image si o něj aplikace řekne sama).
KB_IMAGE_TEXT(prázdné)1 povolí obrázky s čitelným textem (pole Text v obrázku).
KB_AI_GEN_VAHA2Kolik tahů z hodinového stropu (KB_AI_MAX_PER_HOUR) ubere jeden obrázek.
KB_OBRAZEK_KREDITY(prázdné)Pevná cena obrázku v AI kreditech. Prázdné = referenční cena modelu. 0 = obrázky kredity nestojí a týdenní kvóta kreditů je nezastaví.
KB_OBRAZKY_TYDEN(prázdné)Týdenní strop obrázků pro celou instanci (od pondělí). Prázdné nebo 0 = bez stropu. Banner denního sumáře se nepočítá.
KB_SUMAR_EMAIL_MAX100Kolik ranních sumářů e-mailem instance pošle za den.

Přístup a přihlašování ​

Kdy to potřebujete: instance dostupná z internetu (registrační klíč) a přihlašování Googlem.

ProměnnáVýchozíCo dělá
KB_SETUP_CODE(prázdné)Registrační klíč instance. Když je nastavený, vyžaduje ho každá registrace. Prázdné = zaregistrovat se může kdokoli, kdo zná adresu. První zaregistrovaný účet je vždycky správce.
KB_RATE_LIMITS1Serverové brzdy podle IP klienta: přihlášení 20 pokusů / 60 s, zakládání záznamů 20 / 5 s, 300 požadavků na API / 10 s. Zpomalují hádání hesla. 0 = vypnuto.
KB_TRUSTED_PROXY_HEADER(prázdné)Za reverzní proxy (Caddy, nginx — viz HTTPS) by brzdy počítaly IP proxy a celá firma by sdílela jeden kbelík. Nastavte hlavičku, do které proxy zapisuje IP klienta, typicky X-Forwarded-For. Bez proxy nechte prázdné — instance nesmí věřit hlavičce, kterou si klient může podvrhnout.
KB_GOOGLE_CLIENT_ID(prázdné)Google OAuth client ID. Prázdné = tlačítko „Přihlásit přes Google“ se nezobrazuje.
KB_GOOGLE_CLIENT_SECRET(prázdné)Google OAuth client secret.
KB_GOOGLE_PICKER_API_KEY(prázdné)Zapne vybírání příloh přímo z Google Disku. Potřebuje OAuth klienta výš a zapnuté „Google Picker API“ v tomtéž projektu Google Cloud. Takto vybrané soubory se ukládají jako odkazy — z Disku nikam neodcházejí.

Než instanci vystavíte ven, nastavte registrační klíč

Na stroji dostupném z internetu znamená prázdný KB_SETUP_CODE, že si účet založí kdokoli, kdo adresu najde.

E-mail (SMTP) se tady nenastavuje — žije v administraci PocketBase, viz Konfigurace → E-mail.

Automatizace ​

Potřeba jen tehdy, když automatizace na cílech opravdu používáte.

ProměnnáVýchozíCo dělá
KB_PUBLIC_URL(prázdné)Veřejná adresa téhle instance, kterou killBottleneck posílá agentovi jako callback_url, aby se měl kam ohlásit. Stačí jakákoli adresa, na kterou agent dosáhne — u self-hostu klidně adresa v LAN. Když je prázdná, použije se „Application URL“ z administrace PocketBase, což je po instalaci http://localhost:8090 — agent na jiném stroji by pak volal sám sebe. Evidence agentů v aplikaci ukazuje skutečně platnou adresu a před localhostem varuje. Od v0.79 jde tatáž adresa i do OAuth metadat /mcp a do /agent-setup.md; localhost se bere jako nenastaveno a použije se adresa, přes kterou požadavek přišel (Host, X-Forwarded-Host, X-Forwarded-Proto). Za reverzní proxy, která X-Forwarded-Proto neposílá (Caddy posílá), nastavte KB_PUBLIC_URL=https://… výslovně, jinak se instance hlásí jako http:// a MCP klienti OAuth odmítnou.
KB_AGENT_TIMEOUT_MIN90Kolik minut smí automatizace běžet, než ji hlídač označí za neúspěšnou.
KB_ALLOW_PRIVATE_WEBHOOKS(prázdné)1 povolí webhookům agentů mířit i do privátních sítí (10.x, 192.168.x, localhost). Ve výchozím stavu zakázáno.
KB_PRIVATE_WEBHOOK_HOSTS(prázdné)Užší a bezpečnější varianta: čárkami oddělený seznam host:port, které smí být cílem webhooku i v privátní síti (např. n8n.lan:5678); ostatní privátní adresy zůstávají zakázané. Compose ji nepředává — nastavte přes docker-compose.override.yml (viz rámeček nahoře).

Proč jsou privátní webhooky vypnuté

Bez té pojistky jde server zamířit do vaší vnitřní sítě a použít ho k jejímu skenování. Zapněte to, jen když cíl automatizace (třeba n8n) opravdu běží ve stejné LAN.

Limity a režim instance ​

ProměnnáVýchozíCo dělá
KB_FILES_MB(prázdné)Strop v MB pro nahrané přílohy za celou instanci. Prázdné = bez limitu (výchozí pro self-hosting — je to váš disk). 0 = nahrávání vypnuté, přílohy jde přidávat jen jako odkazy.
KB_PAGES10 vypne stránky asistenta (HTML artefakty): nástroje, záložka v panelu i veřejné odkazy /p/….
KB_PAGES_MAX100Kolik stránek smí mít jeden uživatel (Cloud Start 20).
KB_PAGE_KB300Nejvyšší velikost jedné stránky v kB (jeden HTML soubor bez příloh).
KB_PAGE_NUM_PREDICT12000Strop výstupních tokenů pro napsání stránky (Cloud Start 8000); dlouhá stránka = tisíce tokenů, lokální model píše minuty.
KB_PAGE_TIMEOUT280Sekundy na jedno volání modelu při psaní stránky.
KB_AI_PAGE_VAHA3Váha napsání stránky v hodinovém limitu AI (jako obrázek).
KB_HOSTED(prázdné)1 označuje instanci běžící u poskytovatele vedle jiných zákazníků. Správce instance pak nesmí zamířit AI službu do privátní sítě a vypne se kontrola nových verzí. Na vlastním serveru nechte prázdné — lokální Ollama v LAN je tam normální stav.
KB_ENCRYPTION_KEY(prázdné)Přesně 32 znaků. Šifruje API klíč, který si správce hostované instance uloží v sekci Vlastní model nebo API klíč (v databázi leží jen šifrovaně). Bez něj se vlastní model nezapne. Hostingu ho generuje provisioning; na vlastním serveru není potřeba (tam se AI nastavuje v Administraci → AI funkce). Nikdy ho neměňte u běžící instance — uložený klíč by přestal jít přečíst.
KB_SHARE_INVITE_DAILY_CAP20Kolik pozvánek ke sdílenému projektu (adresátům bez účtu) smí jeden uživatel rozeslat za den. Na tutéž adresu k jednomu projektu odejde vždy nejvýš jedna.
KB_SHARE_INVITE_INSTANCE_CAP50Denní strop těchto pozvánek pro celou instanci — ochrana poštovní kvóty.
KB_NOTIFY_EMAIL_DEFAULT(prázdné)Notifikační e-maily jsou ve výchozím stavu vypnuté a řídí se předvolbami uživatelů. 1 zachová po aktualizaci staré chování „e-mail zapnutý, dokud si ho uživatel nevypne“.
KB_REPORT_TO(prázdné)Adresa, kam chodí hlášení chyb a nápadů z aplikace. Prázdné = funkce na téhle instanci neexistuje: položka se nezobrazí a odesílací cesta vrací 404, takže odsud nikdy nic neodejde. Nastavte vlastní adresu, chcete-li hlášení od svých uživatelů — do Reply-To se doplní adresa toho, kdo psal, takže jde odpovědět rovnou z pošty. Vyžaduje funkční SMTP.

Notifikace ​

Výchozí hodnoty jsou rozumné. Měňte je, jen když jsou upozornění moc hlučná — nebo naopak když vaše automatizace oprávněně vyrobí víc než strop.

Žádné „bez omezení“ neexistuje

0 tady není kouzelná hodnota — znamená, že je strop vyčerpaný hned. Místo vynulování číslo zvyšte.

ProměnnáVýchozíCo dělá
KB_NOTIFY_DIGEST_HOUR8Hodina denního souhrnu e-mailem (0–23, místní TZ).
KB_NAVRAT_MAILY1Návratové e-maily pro ty, kdo se dlouho nepřihlásili (vyžaduje SMTP). 0 je vypne.
KB_NAVRAT_DNY3,7,14,30Žebřík dní bez přihlášení, po kterých odejde návratový e-mail — jeden e-mail na stupeň, vždy jen nejvyšší dosažený, po posledním ticho až do dalšího přihlášení.
KB_NAVRAT_HODINA9Hodina odesílání návratových e-mailů (0–23, místní TZ).
KB_NAVRAT_MAX_DENNE10Nejvíc návratových e-mailů na instanci a den (zbytek počká na další den).
KB_REMINDER_CATCHUP_H48Okno pro dohnání připomínek s časem (hodiny, 0–720). Po výpadku se připomínky, jejichž čas je starší než tohle okno, jen zalogují a nepošlou — obnova staré zálohy tak nezasype zvoneček schůzkami, které už proběhly. Mladší zmeškané připomínky přijdou hned po startu.
KB_NOTIFY_DAILY_CAP50Nejvíc upozornění v aplikaci na příjemce a den. Nad strop se jednotlivé řádky nahradí jedním rostoucím souhrnem („+N dalších“) — nic se tiše neztratí.
KB_NOTIFY_EMAIL_DAILY_CAP10Nejvíc notifikačních e-mailů na příjemce a den. Nad strop se e-maily zahazují (upozornění v aplikaci přijde dál).
KB_NOTIFY_COALESCE_MIN10Upozornění pro téhož příjemce, která přijdou během tolika minut, se slijí do jedné zprávy.

První přihlášení ​

Co nový účet a nová instance uvidí poprvé — popsáno v Rychlém startu.

ProměnnáVýchozíCo dělá
KB_UVODNI_MAPA1Zakládat každému novému uživateli dva úvodní projekty (prohlídka + zkušební projekt) a prvnímu správci výchozí sdílené kalendáře Firemní a Nepřítomnosti. 0 = nový účet i instance začínají prázdné.
KB_PURPOSE_ASK1Zeptat se prvního správce při prvním přihlášení K čemu budete killBottleneck používat? (firma / rodina / jen pro sebe). 0 = neptat se (platí firma). Při KB_UVODNI_MAPA=0 se neptá automaticky. 0 vypne i dialog „Připoj svého AI agenta“.
KB_START_RELAX(prázdné)Po spuštění aplikace se sám otevře panel asistenta, jednou za kartu prohlížeče. 1 k němu pustí i akvárium (relax bez odpočtu), 0 nespustí nic.
KB_AGENT_SETUP_ASK1Ukázat každému uživateli jednou po prvním přihlášení dialog „Připoj svého AI agenta“ (jeden řádek do Claude Code / Codexu / Cursoru, viz MCP). 0 = neukazovat; v menu u jména → Připojit AI agenta zůstává. ⚠️ Dodávaný docker-compose.yml tuhle proměnnou zatím nepředává — v .env nemá účinek, nastavte ji přes docker-compose.override.yml (rámeček nahoře).

Aktualizace a verzování ​

ProměnnáVýchozíCo dělá
KB_UPDATE_CHECK1Prohlížeč přihlášeného uživatele se ptá GitHub API, jestli existuje novější vydání; dialog „O aplikaci“ pak nabídne odkaz. Instance sama nikam nic neposílá. 0 kontrolu vypne.
KB_UPDATE_REPO(prázdné)Odkud se čtou vydání. Prázdné = oficiální repozitář. Nastavte jen u vlastního forku.
KB_UPDATE_PRERELEASE01 = kontrola nabídne i předběžná vydání (kandidáty -rc). S výchozí 0 nabízí jen stabilní vydání.
KB_VERSIONdevBuild argument, ne proměnná v .env — předává se na příkazové řádce: KB_VERSION=$(git describe --tags --dirty) docker compose up -d --build. Když zůstane dev, kontrola aktualizací se nenabízí.

Žádná telemetrie

Kontrola aktualizací běží v prohlížeči uživatele proti GitHubu. Instance se nikam neozývá, takže se o vaší instalaci nedozvíme nic.

Kde se KB_VERSION a kontrola nových verzí projeví: menu u jména → O aplikaci.

Souvisí ​

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