Pro administrátory
← Na rozcestník

Řešení potíží

Příznak, příčina a co udělat — od chybějícího přístupu ke schránce po vypršený secret.

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říznakPříčinaCo udělat
set DB_PASSWORD in .env při startuchybí hesla databázedoplnit .env
mailbox … has no access yetschránka nemá registraci ani připojený účetstránka schránky → Přístup k poště
„Organizace nemá nastaveného klienta pro Microsoft 365 nebo Google“ při připojení schránky účtemorganizace nemá klienta v kartě Přihlášení účtem a připojení schránekvlastník organizace ho přidá — viz Microsoft 365 nebo Google Workspace, klient organizace
Graph … 401 … invalid_clientšpatný nebo vypršelý client secretnový secret u registrace, pak test spojení
Graph … 403 … AppOnly AccessPolicyzá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 … ErrorAccessDeniedchybí souhlas správcev Entra u registrace Grant admin consent
Category not added … MailboxSettingschybí oprávnění MailboxSettings.ReadWrite; štítek funguje, jen bez barvypřidat oprávnění a souhlas
No active assistant in the databaseasistent je vypnutý, nebo neproběhlo úvodní naplněnízapnout asistenta; zkontrolovat log startu
asistent se přeskakuje („no prompts yet“)asistent nemá napsané pokynydokončit průvodce, nebo pokyny napsat ručně
vzorek v průvodci hlásí málo datvlastní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 jehoadresu 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 domainskoncept neprošel kontroloupodívat se na zprávu — může jít o pokus o podvrh
Limit reacheddenní limit nebo limit na odesílatelezvýšit jen, když je příval pošty oprávněný
Model refused to answerbezpečnostní filtr modeluzprávu vyřídit ručně
Model exhausted max_iterationsmodel se zacyklil v nástrojíchopakuje se dvakrát; když se to vrací, doladit pokyn Úkol
ECONNREFUSED … 3306databáze neběží nebo ještě nenaběhladocker compose ps, docker compose logs db
pruh „Licence vypršela“ nebo „Instalace nemá licenci“, asistenti nic nepíšoulicence chybí nebo vypršelanahrá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 restartně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 webuDocker 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 chybounová 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í 502vydá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 nespustilv 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ázevýpis databáze selhal (hláška je v kartě); za hodinu se zkusí znovuspustit ./draften backup a přečíst chybu; ověřit místo na disku (df -h) a ./draften status

Když to nevidíte v logu

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

Textová verze