Proměnné prostředí
Všechno se nastavuje v .env vedle docker-compose.yml. Zkopírujte šablonu a upravte:
cp .env.example .envPo každé změně přestavte — restart nestačí:
docker compose up -d --buildStaré 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í:
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_PORT | 8090 | Port, na kterém instance poslouchá: http://IP-SERVERU:PORT. |
KB_NAME | killbottleneck | Název kontejneru. Jiný název = druhá instance vedle první na témže stroji (dřív se dva stacky popraly o jméno). |
TZ | UTC | Č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_HOUR | 5 | Hodina (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_HOUR | 7 | Hodina 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_PROVIDER | none | none = žá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_BUDGET | 4000 | Jen 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_EFFORT | low | Jen 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_MODEL | whisper-1 | Jen pro openai — model přepisu (Groq: whisper-large-v3). Nastavit jde i ve Správě organizace → AI funkce. |
KB_AI_MAX_PER_HOUR | 60 | Jen 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_HOUR | 20 | Kolik 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.
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_HOUR | 6 | Hodina 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_DAYS | 14 | Rá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_TOOLS | auto | Která 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. |
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_CTX | 8192 | Jen 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_TIMEOUT | 45 | Sekund na jeden pokus o přepis. Celkový čas držte hluboko pod časovým limitem reverzní proxy (Cloudflare kolem 100 s). |
KB_VISION_POKUSY | 0 | Kolikrát navíc zkusit první model, než přijde na řadu záloha. |
KB_CHAT_MAX_IMG_MB | 1.2 | Nejvě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_NAHLEDU | 3 | Kolik malých náhledů obrázků drží jeden rozhovor; u starších zůstane jen přepis. |
KB_CHAT_POTVRZENI | app | Kdo 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_TAHU | 10 | Kolik posledních tahů rozhovoru dostává model (2–30). Jen pro měření. |
KB_CHAT_MAX_TOOL_STARE | 600 | Na 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_VAHA | 3 | Kolik 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_S | 300 | Nejdelší 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_MB | 3 | Největší přijatá nahrávka v MB (5 minut Opusu ≈ 1,2 MB). |
KB_AI_HLAS_VAHA | 2 | Kolik tahů z hodinového stropu ubere jeden tah s hlasovkou (přepis + odpověď). |
KB_AI_PDF_VAHA | 2 | Kolik 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_MODEL | gpt-image-1-mini | Jen 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_VAHA | 2 | Kolik 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_MAX | 100 | Kolik 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_LIMITS | 1 | Serverové 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_MIN | 90 | Kolik 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_PAGES | 1 | 0 vypne stránky asistenta (HTML artefakty): nástroje, záložka v panelu i veřejné odkazy /p/…. |
KB_PAGES_MAX | 100 | Kolik stránek smí mít jeden uživatel (Cloud Start 20). |
KB_PAGE_KB | 300 | Nejvyšší velikost jedné stránky v kB (jeden HTML soubor bez příloh). |
KB_PAGE_NUM_PREDICT | 12000 | Strop 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_TIMEOUT | 280 | Sekundy na jedno volání modelu při psaní stránky. |
KB_AI_PAGE_VAHA | 3 | Vá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_CAP | 20 | Kolik 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_CAP | 50 | Denní 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_HOUR | 8 | Hodina denního souhrnu e-mailem (0–23, místní TZ). |
KB_NAVRAT_MAILY | 1 | Návratové e-maily pro ty, kdo se dlouho nepřihlásili (vyžaduje SMTP). 0 je vypne. |
KB_NAVRAT_DNY | 3,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_HODINA | 9 | Hodina odesílání návratových e-mailů (0–23, místní TZ). |
KB_NAVRAT_MAX_DENNE | 10 | Nejvíc návratových e-mailů na instanci a den (zbytek počká na další den). |
KB_REMINDER_CATCHUP_H | 48 | Okno 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_CAP | 50 | Nejví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_CAP | 10 | Nejví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_MIN | 10 | Upozorně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_MAPA | 1 | Zaklá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_ASK | 1 | Zeptat 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_ASK | 1 | Uká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_CHECK | 1 | Prohlíž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_PRERELEASE | 0 | 1 = kontrola nabídne i předběžná vydání (kandidáty -rc). S výchozí 0 nabízí jen stabilní vydání. |
KB_VERSION | dev | Build 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.
Souvisí
- Konfigurace — rozhodnutí místo tabulky
- Aktualizace — co se mezi verzemi mění
- HTTPS a reverzní proxy —
KB_PUBLIC_URL,X-Forwarded-Proto

