Für Administratoren
← Alle Themen

Fehlerbehebung

Symptom, Ursache und was Sie tun – vom fehlenden Zugriff auf ein Postfach bis zum abgelaufenen Geheimnis.

Zuerst das Gesamtbild im Verzeichnis der Installation:

./draften status      # Version, Zustand beider Farben der Weboberfläche und der Worker, HTTPS, Datenbanksicherungen

Dann genauer:

docker compose ps                        # laufen die Dienste, ist die Datenbank gesund?
docker compose logs --tail 50 worker     # die letzten Einträge des Workers
docker compose run --rm worker node diag.mjs mailbox@company.com

Der letzte tut dasselbe wie Verbindung testen in der Oberfläche: Er nimmt den für das Postfach gespeicherten Zugriff, holt ein Token, gibt dessen Berechtigungen aus (nie das Token selbst) und liest den Posteingang.

Häufige Fehler

SymptomUrsacheWas Sie tun
set DB_PASSWORD in .env beim StartPasswörter der Datenbank fehlen.env ausfüllen
mailbox … has no access yetdas Postfach hat keine Registrierung und kein verbundenes KontoSeite des Postfachs → Zugriff auf die Post
„Die Organisation hat keinen Client für Microsoft 365 oder Google eingerichtet“ beim Verbinden eines Postfachs mit dem Kontodie Organisation hat keinen Client in der Karte Kontoanmeldung und Postfachverbindungenein Inhaber der Organisation fügt ihn hinzu – siehe Microsoft 365 oder Google Workspace, Client der Organisation
Graph … 401 … invalid_clientfalsches oder abgelaufenes Client secretein neues Geheimnis bei der Registrierung, dann der Verbindungstest
Graph … 403 … AppOnly AccessPolicydie Application Access Policy wirkt noch nicht, oder das Postfach ist nicht in der Gruppewarten (auch Stunden), den Test wiederholen; das Postfach in die Gruppe aufnehmen
Graph … 403 … ErrorAccessDenieddie Administratorzustimmung fehltin Entra bei der Registrierung Grant admin consent
Category not added … MailboxSettingsdie Berechtigung MailboxSettings.ReadWrite fehlt; die Markierung funktioniert, nur ohne Farbedie Berechtigung hinzufügen und zustimmen
No active assistant in the databaseder Assistent ist ausgeschaltet, oder die Anfangsdaten wurden nicht eingerichtetden Assistenten einschalten; das Startlog prüfen
der Assistent wird übersprungen („no prompts yet“)der Assistent hat keine geschriebenen Anweisungendie Einrichtung abschließen oder die Anweisungen selbst schreiben
die Stichprobe in der Einrichtung meldet zu wenig Datender Inhaber hat früher von einer anderen Adresse geantwortet (etwa vor einem Domainwechsel), und die Einrichtung zählt diese Antworten nicht als seinedie Adresse in das Feld Weitere Adressen des Postfachs eintragen (bei der Stichprobe, im Schritt Zeitraum oder auf der Seite des Postfachs) und die Stichprobe neu wählen; die ganze Adresse, nicht nur die Domain
Draft without signature / links outside the allowed domainsder Entwurf hat eine Prüfung nicht bestandendie Nachricht ansehen – es kann ein Täuschungsversuch sein
Limit reacheddas Tageslimit oder das Limit pro Absendernur erhöhen, wenn die Flut von Post legitim ist
Model refused to answerder Sicherheitsfilter des Modellsdie Nachricht von Hand bearbeiten
Model exhausted max_iterationsdas Modell hat sich in seinen Werkzeugen verfangenzweimal wiederholt; kommt es immer wieder, die Anweisung Aufgabe abstimmen
ECONNREFUSED … 3306die Datenbank ist nicht erreichbar oder noch nicht hochgefahrendocker compose ps, docker compose logs db
die Leiste „Die Lizenz ist abgelaufen“ oder „Die Installation hat keine Lizenz“, die Assistenten schreiben nichtsdie Lizenz fehlt oder ist abgelaufeneine gültige Lizenz hochladen – siehe Die Lizenz
der Webdienst ist kurz nicht erreichbar und laufende Anfragen gehen verloren; im Log des Webdienstes (docker compose logs web-blue web-green) steht ein Neustarteine Anfrage hat die harte Speichergrenze von PHP überschritten (ab PHP 8.5.12 das Doppelte von memory_limit), und PHP hat den ganzen Webprozess beendetDocker startet den Webdienst von selbst neu, meist innerhalb von einigen Dutzend Sekunden; kommt es immer wieder vor, im Log die Anfrage suchen, die die Grenze überschritten hat
eine Aktualisierung endete mit einem Fehlerdie neue Version wurde nicht gesund; die vorherige bedient weiterder Fehler unter Aufträge oder in der Ausgabe von ./draften update; ./draften status
der Webdienst meldet nach einem Neustart des Servers 502Releases vor dem 30. Oktober 2026 schalteten den Webdienst so um, dass Docker den Proxy danach als manuell gestoppt ansah und ihn nach einem Neustart der Maschine nicht wieder starteteim Installationsverzeichnis docker compose up -d --no-deps proxy; dauerhaft behebt es eine Aktualisierung auf das Release vom 30. Oktober 2026 oder neuer
„Die letzte tägliche Sicherung ist fehlgeschlagen“ in der Karte Datenbanksicherungendie Datenbanksicherung ist fehlgeschlagen (die Meldung steht in der Karte); eine Stunde später wird sie erneut versucht./draften backup ausführen und den Fehler lesen; den freien Speicherplatz prüfen (df -h) und ./draften status

Wenn das Log es nicht zeigt

Ein einmaliger Durchgang von Hand

docker compose run --rm worker node worker.mjs --dry-run

Er nimmt jeden aktiven Assistenten einmal und erzwingt den Probemodus – in die Post wird nichts geschrieben. Nützlich, um zu prüfen, dass alles funktioniert.

Wenn Sie unsere Hilfe brauchen

./draften diagnose

schreibt eine Datei diagnose-<time>.tar.gz mit dem Zustand der Installation, den Versionen, der Konfiguration ohne Geheimnisse und dem Ende der Logs. Senden Sie sie uns.

Schauen Sie in die Datei, bevor Sie sie senden: Die Logs können Adressen und Betreffzeilen der verarbeiteten Post enthalten. Von selbst verlässt nichts den Server.

Textfassung