Nejdřív celkový přehled z adresáře instalace:
./draften status # verze, zdraví obou barev webu a workerů, HTTPS, výpisy databáze
Pak podrobněji:
docker compose ps # běží služby, je databáze zdravá?
docker compose logs --tail 50 worker # poslední záznamy workera
docker compose run --rm worker node diag.mjs schranka@firma.cz
Poslední příkaz udělá totéž co Otestovat spojení v rozhraní: vezme přístup uložený pro schránku, získá token, vypíše jeho oprávnění (nikdy token sám) a přečte doručenou poštu.
Časté chyby
| Příznak | Příčina | Co udělat |
|---|---|---|
set DB_PASSWORD in .env při startu | chybí hesla databáze | doplnit .env |
mailbox … has no access yet | schránka nemá registraci ani připojený účet | stránka schránky → Přístup k poště |
| „Organizace nemá nastaveného klienta pro Microsoft 365 nebo Google“ při připojení schránky účtem | organizace nemá klienta v kartě Přihlášení účtem a připojení schránek | vlastník organizace ho přidá — viz Microsoft 365 nebo Google Workspace, klient organizace |
Graph … 401 … invalid_client | špatný nebo vypršelý client secret | nový secret u registrace, pak test spojení |
Graph … 403 … AppOnly AccessPolicy | zásada přístupu aplikace se ještě neprojevila, nebo schránka není ve skupině | počkat (i hodiny), zopakovat test; přidat schránku do skupiny |
Graph … 403 … ErrorAccessDenied | chybí souhlas správce | v Entra u registrace Grant admin consent |
Category not added … MailboxSettings | chybí oprávnění MailboxSettings.ReadWrite; štítek funguje, jen bez barvy | přidat oprávnění a souhlas |
No active assistant in the database | asistent je vypnutý, nebo neproběhlo úvodní naplnění | zapnout asistenta; zkontrolovat log startu |
| asistent se přeskakuje („no prompts yet“) | asistent nemá napsané pokyny | dokončit průvodce, nebo pokyny napsat ručně |
| vzorek v průvodci hlásí málo dat | vlastník dřív odpovídal z jiné adresy (třeba před změnou domény) a průvodce ty odpovědi nepočítá za jeho | adresu přidat do pole Další adresy schránky (u vzorku, v kroku Období, nebo na stránce schránky) a vybrat vzorek znovu; celá adresa, ne jen doména |
Draft without signature / links outside the allowed domains | koncept neprošel kontrolou | podívat se na zprávu — může jít o pokus o podvrh |
Limit reached | denní limit nebo limit na odesílatele | zvýšit jen, když je příval pošty oprávněný |
Model refused to answer | bezpečnostní filtr modelu | zprávu vyřídit ručně |
Model exhausted max_iterations | model se zacyklil v nástrojích | opakuje se dvakrát; když se to vrací, doladit pokyn Úkol |
ECONNREFUSED … 3306 | databáze neběží nebo ještě nenaběhla | docker compose ps, docker compose logs db |
| pruh „Licence vypršela“ nebo „Instalace nemá licenci“, asistenti nic nepíšou | licence chybí nebo vypršela | nahrát platnou licenci — viz Licence |
web na chvíli nejde a rozpracované požadavky se ztratí; ve výpisu webu (docker compose logs web-blue web-green) je restart | některý požadavek překročil tvrdý limit paměti PHP (od PHP 8.5.12 dvojnásobek memory_limit) a PHP ukončilo celý proces webu | Docker web spustí znovu sám, obvykle do desítek sekund; když se to opakuje, najděte ve výpisu požadavek, který limit překročil |
| aktualizace skončila chybou | nová verze se nestala zdravou; slouží dál ta předchozí | chyba v Historii žádostí nebo ve výpisu ./draften update; ./draften status |
| web po restartu serveru hlásí 502 | vydání starší než 30. 10. 2026 přepínala web tak, že Docker pak proxy bral jako ručně zastavenou, a po restartu stroje ji proto nespustil | v adresáři instalace docker compose up -d --no-deps proxy; natrvalo to spraví aktualizace na vydání z 30. 10. 2026 nebo novější |
| „Poslední denní záloha se nepovedla“ v kartě Zálohy databáze | výpis databáze selhal (hláška je v kartě); za hodinu se zkusí znovu | spustit ./draften backup a přečíst chybu; ověřit místo na disku (df -h) a ./draften status |
Když to nevidíte v logu
- Rozhraní: Nastavení asistenta → Aktivita (kontroly pošty, požadavky, události) a stránka Provoz (workery, fronta, chyby za 24 hodin).
- Zpráva po třech neúspěšných pokusech dostane stav selhalo; poslední chyba je v jejím detailu.
Jednorázový průchod ručně
docker compose run --rm worker node worker.mjs --dry-run
Projde všechny aktivní asistenty jednou a vynutí přitom zkušební režim — nic se nezapíše do pošty. Hodí se k ověření, že vše funguje.
Když potřebujete naši pomoc
./draften diagnose
zapíše soubor diagnose-<čas>.tar.gz se stavem instalace, verzemi, konfigurací bez tajemství a koncem logů. Ten nám pošlete.
Než soubor pošlete, podívejte se dovnitř: logy můžou obsahovat adresy a předměty zpracované pošty. Ze serveru sám nic neodchází.