Proměnné prostředí

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

cp .env.example .env

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

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_*.

Základ

Proměnná	Výchozí	Co dělá
KB_PORT	8090	Port, na kterém instance poslouchá: http://IP-SERVERU:PORT.
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 a upozornění na termíny. 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ě).

AI

Proměnná	Výchozí	Co dělá
KB_AI_PROVIDER	none	none = žádná AI (všechno ostatní funguje). api = vzdálená AI služba kompatibilní s killBottleneck API (adresa + token). ollama = váš vlastní lokální model. 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.
KB_AI_TOKEN	(prázdné)	Token pro api / custom.
KB_AI_MODEL	(prázdné)	Jen pro ollama — model, který se má použít (nejdřív ollama pull <model>).
KB_AI_TRANSCRIBE_URL	(prázdné)	Endpoint pro přepis řeči. Když je prázdný, odvodí se z KB_AI_URL.

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_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.

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

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_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.
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.

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_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ě. Na vlastním serveru nechte prázdné — lokální Ollama v LAN je tam normální stav.
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“.

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_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.
KB_UVODNI_MAPA	1	Zakládat každému novému uživateli ukázkovou mapu. 0 = nový účet začíná prázdný.

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_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.