FAQ & Glossar

FAQ

Wenn etwas hakt, schau zuerst hier — die meisten Probleme sind mit ein bis drei Klicks gelöst. Fachbegriffe schlägst Du im Glossar nach.

Login / Berechtigungen

Ich sehe keine Einsätze, obwohl welche da sind.

Du bist wahrscheinlich als Dispo oder SP-Dispo eingeloggt. Der Dispo-Eigentums-Filter zeigt nur Einsätze, bei denen Du als Dispo eingetragen bist oder die Du selbst angelegt hast. Der SP-Dispo sieht nur Einsätze aus seinen Schwerpunkten.

Lösung:

  • Als Admin → /admin/rollen.php → der Rolle die Permission einsatz.view_all über den Rollen-Editor geben (nur für Dispo sichtbar). Permissions sind rollenbasiert, nicht pro Benutzer.
  • Oder: einen Admin bitten, Dir den Einsatz als Dispo zuzuweisen.

„403 Forbidden" beim Klick auf eine Aktion.

Dir fehlt die nötige Permission. Bitte den Admin, Dir die passende Permission über /admin/rollen.php zuzuteilen. Siehe Permission-Matrix.

Ich habe mein Passwort vergessen.

Auf der Login-Seite „Passwort vergessen?" klicken, Benutzername oder hinterlegte E-Mail eingeben — Du bekommst einen Link (30 Minuten gültig, einmalig), über den Du ein neues Passwort vergibst. Das setzt voraus, dass an Deinem Konto eine E-Mail-Adresse hinterlegt ist und der Betreiber den SMTP-Versand eingerichtet hat.

Geht das nicht (keine E-Mail am Konto, SMTP nicht eingerichtet): Admin → /admin/users.php → Deinen User auswählen → E-Mail nachtragen oder „Passwort zurücksetzen". Im Ernstfall (alle Admin-Passwörter weg) muss in der DB direkt das Passwort-Hash-Feld zurückgesetzt werden — sprich uns an.

„Passwort vergessen": Die Reset-Mail kommt nicht an.

Der Reihe nach prüfen:

  1. Spam-/Junk-Ordner checken — die Mail kommt von der unter SMTP_FROM konfigurierten Absender-Adresse.
  2. E-Mail am Konto hinterlegt? Nur Konten mit Adresse bekommen einen Link. Ohne Adresse erscheint stattdessen ein Admin-Hinweis — dann trägt der Admin die Adresse unter /admin/users.php nach (oder setzt das Passwort direkt).
  3. SMTP überhaupt eingerichtet? Steht in config/.env kein SMTP_HOST, ist die Funktion aus und meldet „… E-Mail-Versand ist auf diesem System nicht eingerichtet". Siehe den SMTP-Block in Konfiguration.
  4. Link unbrauchbar / ohne Server-Adresse? org_url in /admin/config.php auf die ETB-URL setzen (z. B. https://etb.example.de) — daraus wird der Link gebaut.
  5. „Zu viele Anfragen"? Ein Rate-Limit bremst wiederholtes Anfordern — ein paar Minuten warten und erneut versuchen.
  6. Versand-Fehler? SMTP-Zugangsdaten/Port/Verschlüsselung prüfen; Details stehen im Log-Dashboard (/admin/log-dashboard.php, Modul USER).

Warum kann ich mich gerade nicht einloggen — „Bitte warte noch N Sekunden"?

Das ist die Brute-Force-Bremse und kein Defekt. Nach 5 fehlgeschlagenen Login-Versuchen (pro Benutzername + IP-Adresse) schaltet das ETB zwischen zwei weiteren Versuchen eine steigende Pflicht-Wartezeit — sie beginnt bei 2 Sekunden und verdoppelt sich bis maximal 60 Sekunden. So braucht ein Angreifer für einen Wörterbuch-Angriff Tage statt Sekunden, während ein vertippter Kamerad schlimmstenfalls eine Minute wartet.

Was Du tun kannst:

  • Einfach die angezeigte Zeit abwarten und es dann nochmal versuchen — mit dem richtigen Passwort.
  • Ein erfolgreicher Login setzt den Zähler sofort zurück.
  • Es gibt keine dauerhafte Sperre: Tut sich eine Weile nichts, löst sich die Bremse von selbst auf (die Fehlversuche zählen nur innerhalb einer Stunde, gespeicherte Einträge werden spätestens nach 24 Stunden gelöscht).

ℹ️ Die Bremse zählt pro Konto + IP. Im Gerätehaus teilen sich oft mehrere Kameraden eine IP — die Wartezeit gilt aber nur für das jeweilige Benutzerkonto, nicht für die ganze Wache. Ein Admin kann niemanden „freischalten": es gibt bewusst keine harte Sperre, die man aufheben müsste.

Ich habe versehentlich alle Häkchen beim Admin abgewählt.

Kein Problem. Der Admin-Failsafe greift immer: Die Rolle Administrator behält alle Rechte, egal was in der Rechteverwaltung steht. Du bist nicht ausgesperrt.

Ich habe die Rolle eines Benutzers geändert — wann wirkt das?

Sofort. Rolle, Aktiv-Status und Einsatz-Rollen werden bei jedem Seitenaufruf frisch aus der Datenbank geprüft. Der betroffene Benutzer muss sich nicht neu anmelden — beim nächsten Klick gilt die neue Rolle.

Ein Benutzer kann sich nicht anmelden, obwohl Konto und Passwort stimmen.

Prüfe seine Rolle. Die Rolle Einsatzkraft hat bewusst keinen Zugang: Der Login weist sie ab, auch mit richtigem Passwort und aktivem Konto. Sie ist ein reiner Empfänger — das Konto macht die Person nur adressierbar, damit ein Alarm sie über ihre Löschgruppe findet.

Soll die Person im Tagebuch arbeiten, gib ihr unter Benutzer eine andere Rolle — mindestens Gast. Der abgewiesene Anmeldeversuch steht als Warnung im Log-Dashboard. Mehr unter Die 7 Rollen.

Ich wurde mitten in der Arbeit ausgeloggt.

Wahrscheinlich hat ein Admin Dein Konto auf inaktiv gesetzt oder Dein Passwort zurückgesetzt — beides beendet laufende Sitzungen sofort beim nächsten Seitenaufruf. Frag den Admin; ist das Konto wieder aktiv, kannst Du Dich normal neu anmelden. (Daneben gibt es das normale Sitzungs-Timeout nach 12 Stunden Inaktivität.)

Ein dritter Fall seit dem Meldungs-Bus: Wurde Deine Rolle auf Einsatzkraft geändert, endet die laufende Sitzung sofort — diese Rolle darf sich nicht anmelden.

Im Einsatz-Rollen-Dialog fehlt ein Benutzer, dem ich eine Rolle leihen will.

Drei Gründe sind möglich:

  • Der Benutzer ist inaktiv — nur aktive Konten erscheinen.
  • Er ist Administrator oder Schwerpunkt-Dispo — diese beiden nehmen am Einsatz-Rollen-System nicht teil.
  • Es bist Du selbst — sich selbst kann man keine Einsatz-Rolle geben.

Mehr dazu unter Einsatz-Rollen.

Ich sehe den Button „Einsatz-Rollen" auf der Einsatz-Übersicht nicht.

Der Button (zwischen „Schwerpunkt erstellen" und „Alarm auslösen") verlangt das Recht „Einsatz-Rollen vergeben" (user.assign_temp_role) — per Default haben es Einsatzleiter und Admin, optional auch die Lage. Gezählt wird Deine effektive Rolle: Seit v4.7.5 reicht dafür auch eine gerade geliehene Einsatzleiter- oder Lage-Rolle, sofern die jeweilige Rolle das Häkchen trägt (Einsatzleiter hat es per Default, Lage nur, wenn der Admin es zuschaltet). Fehlt Dir der Button trotzdem, hast Du weder über Deine feste noch über eine geliehene Rolle das Recht. Unabhängig vom Häkchen sieht ihn zusätzlich die per Alarm-Knopf übernommene Lage (siehe Einsatz-Rollen).

Neben meinem Benutzernamen im Menü steht ein roter Blitz-Knopf — was ist das?

Eine Alarm-Regel mit konfiguriertem Alarm-Knopf hat ausgelöst: Das ETB bietet einmalig eine Einsatz-Rolle (Lage oder Einsatzleiter) zur Selbst-Übernahme an — für den Fall, dass gerade keine Führungsrolle im ETB ist. Als Disponent (ohne aktive Einsatz-Rolle) übernimmst Du die Rolle per Klick und Bestätigung; sie wirkt sofort, und der Knopf verschwindet danach für alle. Hast Du bereits höhere Rechte, bietet der Klick stattdessen das Entschärfen des Angebots an. Details: Einsatz-Rollen.

Cron / Mail-Verarbeitung

Es kommen keine neuen Einsätze rein.

Erste Anlaufstelle: /admin/system-status.php — wie alt ist der letzte Cron-Lauf?

  • Älter als 10 Min: Cron läuft nicht. Crontab prüfen.
  • Aktuell, aber keine Mails: Mail-Postfach prüfen, Subject-Filter in /admin/config.php checken (mail_subject_alarm / mail_subject_unwetter).
  • Mails kommen an, aber kein Einsatz: Mail-Parser-Log unter /admin/log-dashboard.php prüfen.

„Cron läuft nicht."

crontab -l -u www-data    # ist der Job da?
sudo tail -f /var/log/syslog | grep CRON    # läuft er?
curl "https://etb.example.de/cron.php?token=..." # manuell triggern

Wenn der manuelle Curl-Aufruf eine sinnvolle JSON-Response liefert, ist es ein Cron-Setup-Problem (Crontab nicht aktiv). Sonst ist es ein ETB-Problem — Webserver-Logs prüfen.

Cron-Token vergessen.

/admin/config.php → Setting cron_token → Wert kopieren. Wenn Du den auch nicht mehr aufrufen kannst (kein Admin-Zugang), in der DB: SELECT value FROM konfig_hilfsmittel WHERE name = 'cron_token'.

Stichwort-Katalog

Im Einsatz-Formular fehlt mein Stichwort / die Kategorie ist leer.

Im zweiten Auswahlfeld stehen nur aktive Einträge des Stichwort-Katalogs der gewählten Kategorie. Fehlt Dein Stichwort, ist der passende Eintrag entweder inaktiv oder noch gar nicht angelegt — und eine leere Kategorie hat schlicht keine aktiven Stichworte.

Sofort weiterarbeiten: Als Kategorie „— Freitext —" wählen, dann tippst Du das Stichwort frei ein. Dauerhaft beheben: den Katalog unter Admin → Stammdaten → Stichwort-Katalog pflegen (Eintrag anlegen oder auf „aktiv" setzen).

Nach einer Präfix-Änderung sind die Anzeige-Stichworte anders / greifen Alarm-Regeln nicht mehr?

Das ist erwartet. Über „Ausblend-Präfixe → Jetzt anwenden" berechnet das ETB die Anzeige-Varianten aller Katalog-Einträge neu (ein führendes passendes Präfix wird abgeschnitten) — auch von Hand überschriebene Anzeigen, wenn sie vom abgeleiteten Wert abweichen.

Wichtig für Alarm-Regeln: Deren Trigger-Stichworte zielen auf die Anzeige-Variante. Änderst Du die Präfixe, kann sich diese Variante verschieben — prüfe danach die Trigger-Stichworte Deiner Alarm-Regeln, sonst feuern sie nicht mehr. Der Stichwort-Katalog weist beim Anwenden selbst darauf hin.

Telegram

Telegram sendet nicht.

Reihenfolge:

  1. Administration → Meldungen → Telegram → „Selbsttest" öffnen — was sagt er?
  2. Steht der Master-Schalter „Telegram aktiv" auf aus? Er liegt unter Meldungen → Telegram (früher unter Einstellungen → Telegram).
  3. Läuft noch der Debug-Modus? Dann geht alles nur in den Debug-Chat und die Wehr bekommt nichts. Ebenfalls unter Meldungen → Telegram.
  4. Wenn Token ungültig: BotFather → /mybots → richtiges Token kopieren.
  5. Wenn Chat-IDs falsch: @RawDataBot einladen, neue IDs holen.
  6. Bot ist in den Ziel-Chats Mitglied? Bot muss in jedem Chat einmalig per /start angeschrieben werden.

Antworten aus dem Chat kommen nicht als Kommentar an.

Der Rückweg steht nicht. Meldungen → Telegram → „Webhook-Status" öffnen: Die Karte „Wie Rückmeldungen hereinkommen" sagt Dir, was gerade läuft. Steht dort „Kein Rückweg aktiv", hast Du zwei Möglichkeiten:

  • Webhook setzen — unter „Aktionen". Voraussetzung: Deine ETB-URL ist über HTTPS mit gültigem Zertifikat erreichbar und lässt den Aufruf von außen durch.
  • Abholen einschalten — dann fragt der Cron bei Telegram nach. Das braucht kein HTTPS und keinen offenen Zugang von außen.

Wir haben kein HTTPS (oder der Webhook lässt sich nicht setzen) — geht der Rückkanal trotzdem?

Ja. Stell den Rückweg unter Webhook-Status auf Abholen um: Der Cron-Lauf fragt bei Telegram nach, statt sich zustellen zu lassen. Das ist ein ausgehender Aufruf — er braucht weder eine von außen erreichbare Adresse noch ein Zertifikat noch eine Ausnahme in der .htaccess.

Zwei Dinge musst Du dafür wissen:

  • Die Rückmeldungen sind höchstens so frisch wie Dein Cron-Takt. Bei den empfohlenen zwei Minuten merkt das niemand; bei einem stündlichen Cron-Aufruf ist die Sammelmeldung wertlos.
  • Beides gleichzeitig geht nicht. Telegram lässt entweder Webhook oder Abholen zu. Der Knopf „Abholen einschalten" löscht den Webhook deshalb selbst; „Zurück auf Webhook" setzt ihn wieder.

Auf der Webhook-Seite steht dauerhaft „Nichts Neues", obwohl im Chat geantwortet wird.

Dann steht der nächste erwartete Stand zu hoch — das ETB fragt an Telegrams Warteschlange vorbei und bekommt folgerichtig nichts. Klick unter Webhook-Status auf „Stand zurücksetzen"; der nächste Lauf fragt dann von vorn.

Das passiert vor allem nach einem Wechsel des Bot-Tokens. Den anderen Fall — Telegram würfelt seine Nummerierung nach sieben Tagen ohne Verkehr neu — fängt das ETB von selbst ab und fragt automatisch von vorn.

Ich tippe im Chat auf einen Antwort-Knopf, aber es kommt keine Bestätigung mehr.

Läuft Euer Rückweg auf Abholen, ist das normal. Telegram nimmt die Bestätigung zu einem Knopf nur unmittelbar entgegen — bis der Cron abholt, vergehen Minuten, dann ist sie zu alt. Der Kringel dreht aus, ohne Text.

Gezählt hat der Tipp trotzdem. Nachsehen kannst Du unter Rückmeldungen. Eine Ersatznachricht in den Chat schickt das ETB bewusst nicht — bei einem Vollalarm wären das dreißig Bot-Nachrichten in der Gruppe.

Die Rückmeldungen aus dem Chat kamen nie an — und niemandem fiel es auf.

Das ist der klassische Privacy-Mode-Fall. Bis zum Rückkanal lag unter der Nachricht eine Antwort-Tastatur; ein Druck darauf schickte den Text als ganz normale Chat-Nachricht. Solche Nachrichten sieht ein Bot in einer Gruppe aber nur, wenn sein „Privacy Mode" beim BotFather ausgeschaltet ist — ab Werk ist er an. Der Webhook feuerte deshalb nie: kein Fehler, kein Log-Eintrag, keine Rückmeldung.

Du musst dafür nichts umstellen. Seit dem Update hängen die Antworten als Knöpfe an der Nachricht; die erreichen den Bot immer. Ein bislang stiller Rückkanal arbeitet damit von selbst wieder. Kommt trotzdem nichts an, ist der Webhook nicht gesetzt.

Warum kommt meine Rückmeldung im Chat nicht an?

Das ETB nimmt eine Rückmeldung nur aus einem Chat an, in den es selbst sendet. Maßgeblich ist die Liste „Was gerade greift" unter Meldungen → Telegram: Steht die Chat-ID dort nicht, wird die Antwort verworfen und protokolliert. Der Grund ist, dass das Webhook-Secret nur beweist, dass Telegram den Aufruf geschickt hat — nicht, wer dort geschrieben hat.

Die häufigen Fälle:

  • Du hast dem Bot direkt geschrieben. Ein privater Dialog mit dem Bot zählt nicht mehr. Antworte in dem Gruppen-Chat, in den das ETB alarmiert.
  • Die Löschgruppe oder Rolle hat keine Chat-Zuordnung. Dorthin sendet das ETB nicht — und nimmt von dort folglich auch nichts an. Ein Administrator trägt den Chat unter Meldungen → Telegram ein.
  • Der Debug-Modus läuft. Er lenkt alles in den Debug-Chat; nur von dort zählen dann auch die Antworten.
  • Der Schalter „Telegram aktiv" steht auf aus. Dann geht nichts raus und es kommt nichts herein — auch das Abholen ruht.
  • Die Antwort ist zu alt. Was länger als vier Stunden zurückliegt, wird verworfen. Beim Abholen betrifft das vor allem Nachrichten, die in Telegrams Warteschlange lagen, während der Rückweg stand.

Kommt selbst aus dem richtigen Chat nichts an, steht kein Rückweg: Unter Webhook-Status sagt Dir die Karte „Wie Rückmeldungen hereinkommen", ob gerade der Webhook oder das Abholen läuft — oder eben keines von beidem.

„403 Webhook Error" im Log.

Das webhook_secret stimmt nicht mit dem überein, was Telegram mitschickt. Wahrscheinlich hast Du das Secret nach dem Setzen geändert. Lösung: Meldungen → Telegram → „Webhook-Status" → Webhook neu setzen.

Bei mir kommt kein Alarm an, bei den anderen schon.

Häufigste Ursache: Du bist keiner Löschgruppe zugeordnet. Ein Alarm geht an die alarmierten Gruppen — wer in keiner steht, wird von niemandem erfasst. Ein Admin hakt die Gruppen unter Benutzer an. Wie viele Konten davon betroffen sind, sagt die Einstiegsseite von Meldungen.

Zweite Möglichkeit: Die Meldungsart ist abgeschaltet, oder die für Dich greifende Regel adressiert eine andere Gruppe. Beides steht unter Meldungen.

Läuft Deine Wehr auf Web Push, kommen zwei dazu: Du hast auf diesem Gerät nichts eingerichtet, oder Dein Gerät wartet noch auf die Freigabe durch einen Administrator. Beides sagt Dir Dein Profil im Klartext; im Admin steht Dein Name dann unter „Ohne Gerät" bzw. das Gerät mit „wartet auf Freigabe".

Im Zustellprotokoll steht „nur eingeschränkt" oder „nur im ETB sichtbar" — ist das ein Fehler?

Nein. Von den sechs Zustellstatus ist nur „fehlgeschlagen" ein echter Fehler; nur er löst die Eskalation aus.

  • Nur eingeschränkt — raus, aber in einen Gruppen-Chat: Es lesen andere mit, und wer sie gelesen hat, weiß der Kanal nicht.
  • Nur im ETB sichtbar — die Meldung richtet sich an einzelne Personen oder ist eine Entscheidung (Gerät freigeben, Warnung freigeben), und beides kann Telegram nicht: Er stellt an Chats zu, wo jeder Mitleser entscheiden könnte. Sie steht im Postfach. Bei Web Push heißt derselbe Status: diese Person hat kein Gerät eingerichtet.
  • Nicht gesendet — der Kanal ist abgeschaltet oder nicht eingerichtet.
  • Offen — vorgemerkt, der Versand läuft gerade. Die Zeile entsteht bewusst vor dem Senden, damit eine sofortige Rückmeldung vom Sperrbildschirm bereits zählt. Bleibt sie stehen, ist ein Versand mittendrin abgebrochen.

Die vollständige Tabelle steht unter Meldungen.

Postfach & Profil

Wo ist der Menü-Eintrag „Durchsage" hin?

Ins Postfach — und die Seite heißt seit Version 4.9 „Nachricht". Der Knopf „Nachricht verfassen" steht dort ganz oben; verfasst wird sie jetzt dort, wo die Post liegt. Am Recht ändert sich nichts: Ohne „Nachricht verschicken" (mitteilung.durchsage — der Schlüssel blieb) gibt es keinen Knopf.

Was bedeutet die Zahl am Briefsymbol?

Die Anzahl der Meldungen, die auf Dich warten — also alles unter „Wartet auf Dich" im Postfach. Reine Kenntnisnahmen zählen bewusst nicht mit: Eine Zahl, die nie kleiner wird, liest nach zwei Wochen niemand mehr. Ist nichts offen, steht dort keine Null; ab hundert steht 99+.

Hast Du das ETB als App installiert, steht dieselbe Zahl zusätzlich am App-Symbol Deines Startbildschirms (Android und iOS ab 16.4, nur in der installierten App).

Ich sehe nicht mehr, wer sonst zugesagt hat — nur noch eine Zahl.

Dann fehlt Dir das Recht „Rückmeldungen anderer sehen" (mitteilung.rueckmeldungen). Es ist ab Werk bei Administrator, Einsatzleiter und Lage gesetzt und lässt sich im Rollen-Editor vergeben.

Ohne das Recht steht unter der Meldung nur „3 Personen haben zugesagt." — das sagt Dir, ob Du allein unterwegs bist, und verrät niemanden.

⚠️ Bei den Rollen Gast und Einsatzkraft bleibt das Recht wirkungslos, auch gesetzt: An sie gehen grundsätzlich keine Klarnamen.

ℹ️ Nach einem Update fehlt es niemandem, der es haben sollte. Der Schema-Check trägt es einmalig für alle Rollen nach, die schon „Nachricht verschicken" haben.

Beim Anmelden fragt das ETB, ob dieses Gerät Alarme bekommen soll.

Das ist die einmalige Nachfrage auf der Einsatz-Übersicht. Zwei Antworten: „Ja, anmelden" oder „Nächste Woche wieder fragen" — mit der zweiten ist sieben Tage Ruhe.

Dauerhaft abschalten kannst Du sie in Deinem Profil unter „Nachfrage beim Anmelden" → „Auf diesem Gerät nicht mehr fragen". Der Wert gilt für dieses Gerät, nicht für Dein Konto — am Wachrechner abschalten heißt also nicht, dass Dein Handy nicht mehr fragt.

Kann ich meinen Benutzernamen ändern?

Nein. Er ist der Anmeldename und steht in den Protokollen. Name und E-Mail änderst Du selbst im Profil, die Rolle und die Löschgruppen nur ein Administrator unter Benutzer.

Ich habe mein Passwort im Profil geändert — jetzt bin ich abgemeldet.

Das ist Absicht. Ein neues Passwort beendet alle Sitzungen des Kontos, auch die eigene — so sperrt es jeden aus, der mit dem alten noch irgendwo offen ist. Melde Dich einfach mit dem neuen Passwort wieder an.

Web Push

Im Profil fehlt der Knopf „Dieses Gerät anmelden".

Dann kann Dein Gerät hier keine Benachrichtigungen empfangen — statt des Knopfs steht dort der Grund im Klartext. Die häufigen Fälle:

  1. „Auf iPhone und iPad braucht es einen Schritt mehr" — Du hast die Seite noch nicht über Teilen → „Zum Home-Bildschirm" installiert. Und: den Link zuerst in Safari öffnen, nicht im eingebauten Browser von WhatsApp oder Telegram.
  2. „Dieses Gerät kann keine Alarme empfangen" — die Instanz läuft nicht über HTTPS (dann sperren alle Browser Benachrichtigungen), oder Dein Browser kann keine Hintergrund-Benachrichtigungen.
  3. „Die Zustellung ist noch nicht eingerichtet" — Deine Wehr hat den Schlüssel für Web Push noch nicht erzeugt; das macht ein Administrator einmalig unter Web Push.

Läuft Deine Wehr noch auf Telegram, steht im Profil statt der Geräteliste der Hinweis, dass die Alarme über den Chat laufen — dann gibt es dort nichts einzurichten. Ausnahme: Bist Du bei einer Erprobung dabei und hat die Verwaltung Dir Web Push zugeteilt, erscheint die Geräte-Karte trotzdem — maßgeblich ist Dein Weg, nicht der der Wehr (siehe Meldungen → „Erprobung").

Mein Gerät steht auf „Unbewiesen" — ist es kaputt?

Nein. Unbewiesen heißt: ungeprüft. Das ETB weiß nur dann sicher, dass ein Gerät klingelt, wenn es den Empfang selbst bestätigt hat — und das tut es erst, wenn wirklich eine Meldung ankam. Lief bei Euch vier Wochen kein Alarm, steht die ganze Wehr auf „unbewiesen".

Der Test dauert zehn Sekunden: im Profil beim Gerät auf „Probealarm senden" tippen. Kommt er an, steht dort danach Erreichbar.

Steht dort „zuletzt abgeschickt … — angekommen ist sie aber nie bestätigt worden", hat der Push-Dienst die Meldung zwar angenommen, aber Dein Gerät hat sich nie zurückgemeldet. Das ist genau der Fall, für den es den Probealarm gibt.

„Dieses Gerät wartet noch auf die Freigabe durch einen Administrator."

Deine Wehr hat die Freigabe neuer Geräte eingeschaltet (Vorgabe ist aus). Bis ein Administrator freigibt, bleibt das Gerät still — es bekommt keine Alarme, und auch kein Probealarm geht durch. Das ist Absicht: Ein Probealarm, der klingelt, während echte Alarme nicht ankommen, wäre eine Attrappe.

Der Administrator gibt es frei — im Postfach an der Meldung „Neues Gerät: …" oder in der Geräte-Liste unter Web Push.

Kann ich einen Probealarm schicken, so oft ich will?

Höchstens alle 30 Sekunden, gezählt je Person über alle Geräte und Browser hinweg. Sonst kommt „Einen Moment — ein Probealarm alle 30 Sekunden reicht." Jeder Probealarm ist ein echter ausgehender Versand; ohne Sperre ließe sich damit der Server beschäftigen.

Ich habe keinen Zugang zum ETB — wie bekomme ich trotzdem Alarme aufs Handy?

Über einen Einladungslink. Die Rolle Einsatzkraft kann sich bewusst nicht anmelden; Dein Administrator erzeugt Dir den Link unter Meldungen → Web Push und gibt ihn Dir. Du öffnest ihn auf dem Gerät, das alarmiert werden soll, vergibst einen Gerätenamen und erlaubst die Meldungen.

Der Link gilt 14 Tage und genau einmal — und er ist keine Anmeldung: Ins Einsatztagebuch kommst Du damit nicht.

Der Einladungslink sagt „Link nicht gültig".

Er ist abgelaufen, schon benutzt oder falsch kopiert. Einen neuen gibt es beim Administrator; einen alten wieder anzuzeigen ist bewusst nicht möglich, gespeichert ist nur seine Prüfsumme.

Nach dem Umschalten auf Web Push kommt bei der halben Wehr nichts mehr an.

Das ist die typische Falle: Nach dem Umschalten gilt genau ein Weg für alle. Wer kein Gerät eingerichtet hat, ist ab dem Umschalten nicht mehr erreichbar — und wer bisher ohne ETB-Konto im Telegram-Chat mitgelesen hat, erst recht nicht.

Sofortmaßnahme: unter Meldungen → Zustellweg zurück auf Telegram stellen, dann in Ruhe Geräte einrichten. Die Zahl „Ohne Gerät" auf der Web-Push-Seite sagt Dir, wann es soweit ist.

Damit es beim nächsten Mal nicht wieder passiert: Starte vorher eine Erprobung (Meldungen → „Erprobung") und gib ein paar Freiwilligen den neuen Weg — am besten zusätzlich zu Telegram. Dann siehst Du an echten Alarmen, ob der Push wirklich weckt, bevor Du für alle umlegst.

„Das Gerät konnte nicht gespeichert werden. Ist es bereits für jemand anderen eingerichtet?"

In aller Regel ja — denn ein Gerät gehört einer Person. Typisch am geteilten Fahrzeug-Tablet: Dort hat schon jemand eingerichtet, und der Browser gibt beim zweiten Versuch dasselbe Abo zurück. Früher wanderte das Gerät dabei still zum Zweiten und der Erste war ohne Alarm, ohne es zu merken; heute wird der Versuch abgewiesen. (Dieselbe Meldung erscheint auch, wenn das Speichern aus einem anderen Grund scheitert — was genau, steht im Log-Dashboard.)

Lösung: Der bisherige Besitzer meldet sich in seinem Profil über „Abmelden" ab — oder ein Administrator entfernt die Zeile in der Geräte-Liste unter Web Push. Danach klappt das Einrichten.

Ich habe auf dem Sperrbildschirm geantwortet — es kommt „Rückmeldung fehlgeschlagen".

Der Weg über die Benachrichtigung gilt genau einmal und vier Stunden ab der Meldung. Hast Du schon geantwortet oder ist die Meldung älter, weist das ETB die zweite Antwort ab. Umentscheiden kannst Du Dich dann im Postfach — dort bleiben die Knöpfe stehen, und es zählt die letzte Antwort.

ℹ️ Steht in der Meldung ausdrücklich „Diese Rückmeldung wurde schon abgegeben.", ist nichts verloren: Deine erste Antwort hat gezählt.

ℹ️ Sehr schnelles Antworten ist kein Grund mehr. Früher konnte der Tipp scheitern, wenn er kam, bevor die Meldung an alle anderen draußen war — ausgerechnet den Schnellsten traf es. Der Antwort-Ausweis gilt jetzt ab dem Versand.

⚠️ Die vier Stunden gelten auch in der App. Ist die Meldung älter, antwortet auch der Knopf im Postfach mit „Diese Meldung ist für Dich nicht mehr offen." Eine Rückmeldung auf einen längst abgearbeiteten Alarm hilft niemandem — sie würde im Lagebild eines beendeten Einsatzes landen.

ℹ️ Für Entscheidungen gelten 14 Tage statt vier Stunden — also für „Gerät freigeben" und „Warnung freigeben". Eine Freigabe verfällt nicht, weil ein Vormittag vergangen ist; wer sie am Freitag anstößt, soll sie am Montag noch treffen können. Siehe Postfach.

Ein weiterer Grund: Dein Konto ist deaktiviert — dann werden Antworten grundsätzlich abgewiesen.

ℹ️ Kommt gar keine Bestätigung (weder „gesendet" noch „fehlgeschlagen"), hatte das Gerät im Moment des Tippens kein Netz. Die Rückmeldung ist dann nicht angekommen — bitte in der App nachholen. Meldet die Benachrichtigung ausdrücklich „Rückmeldung NICHT gesendet", gilt dasselbe: Sie bleibt stehen, bis Du sie wegtippst.

In der Sammelmeldung steht „(aus dem Chat)" hinter einem Namen.

Diese Rückmeldung kam über einen Knopf an der Telegram-Nachricht. Der Name daneben ist der Chat-Name, den sich jeder selbst gibt — kein ETB-Klarname. Gezählt wird die Antwort trotzdem; die Kennzeichnung sagt nur, dass Du dem Namen nicht dieselbe Verbindlichkeit geben kannst wie einer Rückmeldung aus der App oder von einem eingerichteten Gerät. Läuft Deine Wehr auf Web Push, verschwindet der Zusatz von selbst.

Auf der Seite „Rückmeldungen" steht hinter Einträgen ein „alt".

Die Zeile kommt aus dem Telegram-Chat — entweder aus der Zeit vor dem Meldungs-Bus oder von einem Knopf an einer Telegram-Nachricht. Sie trägt keinen ETB-Benutzer und keinen Zusatztext. Filterst Du auf einen Einsatz, fallen diese Zeilen heraus; der Filter arbeitet auf dem Bus. Einem Schwerpunkt-Dispo werden sie gar nicht angezeigt: Ohne Einsatzbezug lassen sie sich nicht auf seinen Schwerpunkt eingrenzen. Siehe Rückmeldungen.

Wir haben den Schlüssel neu erzeugt — jetzt geht gar nichts mehr.

Der öffentliche Teil des Schlüssels steckt in jedem eingerichteten Gerät. Nach einem Wechsel sind alle Abos wertlos, ohne dass irgendwo ein Fehler erscheint. Es hilft nur: jedes Gerät neu einrichten (bzw. neue Einladungen verschicken). Deshalb bietet die Seite dafür keinen Knopf an.

Alarmmonitor / Hallenbildschirm

Der Schirm in der Halle zeigt nichts

  1. Läuft ein Einsatz? Ohne laufenden Einsatz zeigt der Monitor mit Absicht den Warte-Zustand: Uhrzeit, Datum und das Wetter. Das ist kein Fehler.
  2. Steht unten links „Verbindung unterbrochen — Anzeige veraltet"? Dann kommt der Schirm nicht mehr an den Server. Netz prüfen; die Anzeige fängt sich von selbst wieder.
  3. Wurde der Zugang widerrufen? Dann landet der Schirm auf der Anmeldeseite. Unter Meldungen → Rückmeldungen einen neuen Zugang anlegen und die Adresse erneut aufrufen.

Ich habe die Adresse des Bildschirm-Zugangs verloren

Sie steht in der Liste unter Meldungen → Rückmeldungen. Vier Symbole je Zeile: anzeigen, kopieren, erneuern und widerrufen. Erneuern vergibt eine neue Adresse — der Schirm muss danach einmal neu aufgerufen werden, die alte gilt dann nicht mehr.

Wie oft aktualisiert der Monitor?

Alle 10 Sekunden, einstellbar unter Meldungen → Rückmeldungen. Die verbleibenden Sekunden stehen unten links — aber nur, solange ein Einsatz läuft. Im Warte-Zustand gibt es nichts zu zählen.

Die Karte ist verrutscht, nachdem ich die Schrift vergrößert habe

Sie zeichnet sich beim nächsten Takt neu. Wenn nicht, einmal die Seite neu laden.

Wetter

Die Wetter-Kacheln sind leer oder die Seite lädt lange

Beim ersten Aufruf nach einer Pause ist der Zwischenspeicher kalt — dann holt der Server die Daten erst. Läuft der Cron, passiert das im Hintergrund, bevor jemand die Karte öffnet. Ohne Cron wartet immer die erste Person. Unter Wetter → Zwischenspeicher siehst Du, was vorliegt, und kannst mit dem Probe-Knopf messen.

Regen wird angezeigt, Blitze nicht

Die Gewitter-Vergangenheit hebt das ETB selbst auf — der Dienst liefert nur „ab jetzt". Nach zwei Stunden Cron-Betrieb ist die Zeitleiste vollständig. Steht auf der Karte „Gewitter: nur ab jetzt", ist genau das der Grund.

„Nicht freigeschaltet" an der Wetter-Kachel

Das Wetter ist ein Zusatzmodul. Freischalten unter Administration → Konfiguration → Wetter → Freischaltung. Siehe Wetter verwalten.

Datenbank / Schema

Eine Aktion meldet „Interner Fehler — Details im Log-Dashboard."

Das ETB zeigt bei unerwarteten Fehlern bewusst keinen technischen Text mehr im Browser (keine SQL-Meldungen, Pfade oder Tabellennamen) — solche Interna gehören nicht zum Endnutzer. Was wirklich passiert ist, steht im Klartext im Log-Dashboard (/admin/log-dashboard.php). Gezielte Hinweise wie „Name fehlt." oder „Einsatzmittel ist aktuell im Einsatz" siehst Du weiterhin direkt — die sind als bewusste Validierungsmeldungen vom Maskieren ausgenommen.

ℹ️ Wenn der Browser Dir gar nichts anzeigt (weiße Seite, statt einer Meldung), liegt der Grund ebenfalls im Log: das ETB schreibt PHP-Fehler grundsätzlich ins Log statt auf den Bildschirm (display_errors ist serverseitig aus). Schau ins PHP-Error-Log (siehe „Wenn nichts hilft" am Ende).

„Table doesn't exist" / 500-Fehler nach Update.

Schema-Migration nicht gelaufen. /admin/schema-check.php öffnen → „Reparieren" — die fehlenden Tabellen, Spalten und Defaults werden migriert.

Der Schema-Banner in der Sidebar zeigt automatisch an, wenn das fällig ist.

Schema-Banner geht nicht weg, obwohl ich migriert habe.

Die Schema-Prüfung wird je Anmeldung eine Stunde zwischengespeichert. Logout + Login löst den Cache. Oder Browser-Tab schließen und neu öffnen.

Die Page-spezifischen Feature-Banner (z. B. auf /admin/alarm-regeln.php) sind nicht gecached — sie zeigen sofort den korrekten Zustand.

„Schwerpunkt-Dispo"-Rolle lässt sich nicht speichern.

Deine Installation hat noch ein altes ENUM auf users.role aus dem Migrations-Skript 008_create_users.sql. Lösung: /admin/schema-check.php → „Reparieren" — die Spalte wird auf VARCHAR(32) migriert. Anschließend den User unter /admin/users.php einmal kurz bearbeiten und die Rolle nochmal auf „Schwerpunkt-Dispo" setzen.

Wichtigkeit „Bereitstellung" lässt sich nicht setzen.

Gleicher Mechanismus: alte ENUM auf einsaetze.wichtigkeit. /admin/schema-check.php → „Reparieren" — die Spalte wird auf VARCHAR(32) migriert + die Wichtigkeitsstufe bereitstellung wird geseedet.

Die DB hat einen anderen Präfix als die App erwartet.

Im .env-File ist DB_TABLE_PREFIX falsch gesetzt. Wert korrigieren und Browser-Reload — die App nutzt den neuen Präfix sofort.

Wenn Du die DB-Tabellen wirklich umbenennen willst (Migration auf neuen Präfix), gibt es dafür ein Hilfsmittel — sprich uns an.

PDF-Export

PDF ist leer.

Wahrscheinlich werden die Anhänge gerade gerendert und der Browser hat zu früh abgebrochen. Reload (Strg+F5). Oder kleiner Filter setzen (kürzerer Zeitraum, weniger Einsätze).

PDF zeigt keine Bilder.

Sicher, dass die Anhänge auf der Platte noch existieren? Schau in storage/uploads/. Wenn die Datei weg ist (z. B. nach einem fehlgeschlagenen Restore), kann der PDF-Renderer sie nicht einbetten.

Lagekarte

Einsatzmarker stehen falsch.

Geocoding-Cache hat einen Treffer mit falschen Koordinaten. Auf /geocode-admin.php die Adresse suchen, löschen, beim nächsten Reload wird neu aufgelöst.

Wenn das Geocoding generell daneben liegt: geocode_suffix in /admin/config.php prüfen — passt der zu Deiner Region?

Heatmap zeigt nichts an.

Zu wenig Einsätze für eine sinnvolle Dichte. Oder im Wichtigkeits-Filter die Stufen abgehakt? Alle Häkchen setzen, dann wieder schauen.

Alarm-Regeln (UW-ERSTALARM)

/admin/alarm-regeln.php ist leer, nur ein „Wie funktioniert das?".

Die Default-Regel UW-ERSTALARM wurde nicht geseedet. Auf der Seite selbst gibt es einen gelben Hinweis-Block mit Button „Default UW-ERSTALARM-Regel anlegen" — klick den. Er legt automatisch fehlende Tabellen, die Wichtigkeit bereitstellung und die Regel + Followups an.

UW-ERSTALARM-Mail kommt rein, aber keine Folge-Einsätze entstehen.

Reihenfolge prüfen:

  1. /admin/alarm-regeln.php öffnen — ist die Regel da und auf „aktiv"?
  2. Stimmt das Trigger-Stichwort exakt mit dem Mail-Stichwort überein? (Case-insensitiv, aber sonst exakt.)
  3. Im Log-Dashboard unter Modul EINSATZ nach „Multi-Alarm-Regel ausgeloest" suchen — dort steht, ob die Regel gefeuert hat.
  4. Wenn ja, aber Folge-Einsätze fehlen: nach „Folge-Einsatz fehlgeschlagen"- Eintrag suchen. Häufige Ursache: die im Followup gewählte Wichtigkeit existiert nicht (Stammdaten checken).

Anzeige „Verarbeitete Alarme: 0" obwohl Einsätze rein kamen.

Die Anzeige im System-Status zeigt die Anzahl seit dem letzten ETB-Reset plus den 24-Stunden-Counter — beide aus der einsaetze-Tabelle. Zeigt sie dauerhaft 0, wurde entweder seither zurückgesetzt oder es liegen im 24-Stunden-Fenster keine Einsätze.

Die Leitstelle schickt keine Mail — kann ich den Alarm selbst anstoßen?

Ja. In der Einsatz-Übersicht gibt es den Knopf „Alarm auslösen": Er löst eine Folge-Einsatz-Alarmregel (z. B. UW-ERSTALARM) von Hand aus und legt — wie der echte Mail-Alarm — den Basis-Einsatz plus die Folge-Einsätze an der gewählten Adresse an und alarmiert über den eingestellten Zustellweg. Den Knopf siehst Du nur mit dem Recht „Alarm manuell auslösen" (Default Lage/Einsatzleiter/ Admin; eine geliehene Einsatz-Rolle zählt mit). Vollständige Anleitung unter Alarm-Regeln → Manuelle Auslösung.

„Diese Alarmregel wurde gerade ausgelöst. Bitte warte noch N Sekunden."

Das ist der Cooldown gegen versehentliche Doppelauslösung: Nach einer manuellen Auslösung ist dieselbe Regel 60 Sekunden gesperrt (und höchstens 10-mal pro Stunde auslösbar). Die Sperre hängt an der Regel, nicht am Benutzer — sie greift also auch, wenn jemand anderes gerade ausgelöst hat. Der automatische Mail-Alarm bleibt unberührt. Warte die angezeigte Restzeit ab oder nimm eine andere Regel.

Schwerpunkte

Einsatz landet nicht im Schwerpunkt.

  • Ist der Schwerpunkt im Status aktiv? pausiert schaltet die Auto-Zuweisung ab.
  • Ist der Schwerpunkt im Modus Orte? Im Modus Einsätze gibt es keine Auto-Zuweisung.
  • Passt der Ort des Einsatzes zu einem der Orte des Schwerpunkts? (Großschreibung egal, Aliase werden beachtet.)
  • Manuell zuweisen geht immer: ETB-Übersicht → Einsatz-Zeile → Symbol „Zuweisen".

Schwerpunkt lässt sich nicht erledigen.

Es gibt noch Einsätze im Schwerpunkt, die weder erledigt noch abgeschlossen sind — fürs Erledigen des Schwerpunkts reicht bei jedem Einsatz „mindestens erledigt". Auf der SP-Edit-Page siehst Du eine Liste; am schnellsten geht es im Schwerpunkttagebuch über „Einsätze abschließen". Falls ein Einsatz „Abschnitte in Arbeit" meldet: erst die Abschnitte erledigen (geht direkt im jeweiligen Dialog), dann den Einsatz.

Benutzer-Verwaltung

SP-Dispo auto-löschen geht nicht.

Es gibt aktuell kein Auto-Delete beim Schließen eines Schwerpunkts. Was es gibt: Setting sp_dispo_delete_on_reset (Default ja) — beim ETB-Reset (/admin/etb-reset.php) werden alle SP-Dispo-User mitgelöscht. Wenn Du einzelne SP-Dispos loswerden willst: in /admin/users.php auf „inaktiv" setzen — dann tauchen sie in den Dropdowns nicht mehr auf, bleiben aber für die Audit-Historie erhalten.

Ich kann keinen User löschen.

User mit zugewiesenen Einsätzen, Schwerpunkten oder Abschnitten können nicht gelöscht werden — wer hätte dann historisch die Mutation gemacht? Stattdessen: User deaktivieren (active = 0), dann taucht er in Dropdowns nicht mehr auf.

Nach dem Löschen eines Benutzers stimmt die Zustellquote alter Einsätze nicht mehr.

Das ist so gewollt. Die Zeilen im Zustellprotokoll sagen, wer wann welche Meldung bekam und was er geantwortet hat — persönliche Daten, die mit dem Konto verschwinden. Aus „12 von 20" wird dadurch „12 von 19". Die Meldungen selbst bleiben, sie gehören dem Einsatz.

Brauchst Du den Nachweis unverändert, erzeuge ihn vor dem Löschen — oder setze das Konto nur auf inaktiv. Mehr unter Benutzer.

Anhänge

Gast kann mein PDF nicht herunterladen.

Per Default sperrt das ETB für Gäste den Download von Dokumenten (PDF, Audio, Office). Bilder gehen. Wenn Du dem Gast PDFs geben willst, gib seiner Rolle die Permission anhang.download_document.

„File too large".

PHP-Limits prüfen: upload_max_filesize und post_max_size in der php.ini. Default 2 MB ist für moderne Smartphone-Fotos viel zu wenig — setz auf mindestens 20 MB.

Performance

ETB ist langsam.

  • DB-Indizes komplett? /admin/schema-check.php zeigt fehlende Indizes an, „Jetzt anlegen" klicken.
  • Geocode-Cache aufgebläht? Auf /geocode-admin.php Größe prüfen und ggf. flushen.
  • storage/uploads/ voll? Alte Anhänge archivieren.

Wenn nichts hilft

  1. Logs lesen: /admin/log-dashboard.php zeigt alles — Cron-Log, Webhook-Log, Audit-Log.
  2. Webserver-Log: meist unter /var/log/apache2/error.log oder /var/log/nginx/error.log.
  3. PHP-Error-Log: pfad-abhängig, oft /var/log/php_errors.log.
  4. Issue auf GitLab: https://gitlab.com/brun-soft/das-etb/-/issues — mit Beschreibung was passiert ist, was Du erwartet hattest, und den relevanten Log-Auszügen.

Begriffe nachschlagen? → Glossar.