---
title: "KeyHelp: Wartungsmodus aktivieren und Kunden informieren"
date: 2026-10-01T23:57:17+02:00
modified: 2026-11-08T22:35:52+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-wartungsmodus-aktivieren-kunden-informieren
keywords:
  - KeyHelp
  - Wartungsmodus
  - Serverwartung
  - Kundenkommunikation
  - Webhosting
reading_time: 7
---

# KeyHelp: Wartungsmodus aktivieren und Kunden informieren

Bei Arbeiten am Server oder am Control Panel sollen Kunden nicht mitten in einer Änderung im Panel stehen. KeyHelp bringt dafür einen Wartungsmodus mit: Er sperrt die Panel-Anmeldung für alle außer den Adressen, die Sie ausnehmen, und zeigt Besuchern einen festen Hinweis. Diese Anleitung zeigt, wie Sie den Modus einschalten, ohne sich selbst auszusperren, was Kunden und Admins dann sehen, was weiterläuft und wie Sie Kunden vorab per Rundmail informieren. Alles haben wir in einer Test-VM real ausgeführt, einschließlich einer bewussten Selbstaussperrung und der Rettung über die Konsole. Grundlage ist ein Server wie in [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** Unter „Konfiguration“, „Wartungsmodus“ setzen Sie den Haken „Aktiviert“ und tragen unter „Vom Wartungsmodus ausgeschlossene IPs“ Ihre eigene Adresse ein. Alle anderen bekommen beim Panel den HTTP-Status 503 und den Text „Das Server Control Panel ist aufgrund von Wartungsarbeiten vorübergehend nicht erreichbar.“ Auch bereits angemeldete Kunden bekommen sofort die Wartungsseite. Websites, Webmail und Mailzustellung laufen weiter. Fehlt Ihre eigene IP in der Liste, sperren Sie sich ohne Warnung aus. Dann hilft `keyhelp-toolbox`, Punkt 5. Kunden informieren Sie vorher über „E-Mail an alle Benutzer“, einen eigenen Meldungstext für die Wartungsseite gibt es nicht.

## Voraussetzungen

- [ ] **KeyHelp-Server** mit Admin-Zugang, zum Beispiel KeyHelp 26.1.1 auf Debian 12.
- [ ] **Root-Zugang per SSH oder Konsole** als Rückweg, falls Sie sich aussperren.
- [ ] **Ihre öffentliche IP-Adresse**, von der aus Sie das Panel bedienen. KeyHelp zeigt sie auf der Seite an.
- [ ] Läuft der Browser über einen Reverse Proxy, sieht KeyHelp dessen Adresse als „eigene IP“. Kundenzugriffe lassen sich per `curl` direkt auf dem Server mit einer `keyhelp login`-Sitzung eines Kunden nachstellen.

## Schritt 1: Kunden vorab informieren

Der Wartungsmodus selbst verschickt keine Nachricht und hat kein Feld für einen eigenen Text. Kündigen Sie die Wartung deshalb vorher an: „E-Mail an alle Benutzer“ im Menü unter „Sonstiges“. Wählen Sie unter „Empfänger“ „Kundenkonten“ (dahinter steht die Anzahl), füllen Sie „Betreff“ und „Nachricht“ und testen Sie die Mail über „E-Mail-Nachricht testen“ an eine eigene Adresse.

![KeyHelp-Formular E-Mail an alle Benutzer mit Empfänger Kundenkonten, Betreff und Nachricht zur Wartung](https://s-edv.com/uploads/2026/10/9175ce0b4cd3a0a4b95097381c1dd5fb76d66805f0905a6b468f6eeff7d742d0-1024.png)
*Ankündigung an alle Kundenkonten über „E-Mail an alle Benutzer“*

Nach „E-Mail senden“ meldete KeyHelp „Die E-Mail wurde erfolgreich an 1 Empfänger versendet.“ Laut Hinweis im Formular werden „die Absenderoptionen verwendet, wie sie unter Benachrichtigungen konfiguriert sind“.

> **Prüfen:** Die Mail lag im Postfach des Testkunden, Absender und Empfänger aus den Kopfzeilen:
>
> ```plaintext
> To: Max Mustermann <info@kunde1.example.de>
> From: Support <root@server.example.de>
> Subject (dekodiert): Wartungsarbeiten am Control Panel heute 22 bis 23 Uhr
> ```

In unserer Testinstallation war der Absender also `root@` des Server-Hostnamens. Prüfen Sie die Absenderoptionen unter „Benachrichtigungen“, bevor Sie Kunden anschreiben. Die Mail kommt im KeyHelp-Design mit Logo-Platzhalter und Link auf den Server.

## Schritt 2: Wartungsmodus mit eigener IP aktivieren

Öffnen Sie „Konfiguration“, „Wartungsmodus“. Die Seite erklärt: „Wenn aktiviert, wird die Anmeldung nur noch für die unten aufgeführten IPs / IP-Bereiche angezeigt.“ Darunter nennt KeyHelp Ihre aktuelle Adresse: „Sie sollten mindestens Ihre eigene IP … angeben“. In unserem Test war das Feld mit dieser Adresse bereits vorbelegt.

![KeyHelp-Seite Wartungsmodus mit Haken Aktiviert, Liste der ausgeschlossenen IPs und Hinweis auf keyhelp-toolbox](https://s-edv.com/uploads/2026/10/07ebeaf5444f15614c1ce1ad614d0060e873b861c3252b90fbd2536a34b6f265-640.png)
*„Wartungsmodus“ mit eigener IP in der Ausnahmeliste*

Setzen Sie den Haken „Aktiviert“, prüfen Sie die Liste (eine Adresse oder ein Bereich pro Zeile) und klicken Sie „Speichern“. Die Meldung lautet „Die Einstellungen wurden aktualisiert.“, darunter steht gelb „Der Wartungsmodus ist aktiviert.“ Denselben gelben Hinweis zeigte danach auch das Dashboard.

Gespeichert wird der Zustand in der KeyHelp-Datenbank, nicht in einer Apache-Datei:

```bash
$ mysql keyhelp -e "select * from settings where id in (206,207)"
```

```bash
id	category	name	value
206	maintenance	is_enabled	1
207	maintenance	excluded_ips	203.0.113.10
```

Die IDs 206 und 207 gelten für unsere Installation. Allgemein finden Sie die Zeilen mit `select * from settings where category="maintenance"`, so wie in Schritt 5 und bei der Rettung über die Konsole.

> **Prüfen:** Ein Aufruf der Panel-Startseite von einer nicht ausgenommenen Adresse liefert 503 statt der Anmeldeseite. Auf dem Server selbst (127.0.0.1 steht nicht in der Liste):
>
> ```bash
> $ curl -skI --resolve server.example.de:443:127.0.0.1 https://server.example.de/ | grep -iE "^(HTTP|retry-after|cache-control)"
> ```
>
> Ausgabe:
>
> ```plaintext
> HTTP/2 503
> ```

Vor dem Aktivieren lieferte die Startseite 200 mit Passwortfeld. Die Apache-Konfiguration fasst KeyHelp dabei nicht an: `grep -rl -i maintenance /etc/apache2/keyhelp` fand während des aktiven Modus keine Datei. Das spricht dafür, dass die Panel-Anwendung selbst anhand der Datenbank sperrt. Die letzten Einträge im Apache-Fehlerprotokoll stammten vom Start vor dem Test, ein Neuladen war für die Sperre also nicht nötig. Einen `Retry-After`-Header sendet KeyHelp nicht.

## Schritt 3: Was Kunden sehen

Besucher ohne Ausnahme sehen statt der Anmeldung eine schlichte Seite mit KeyHelp-Logo:

![KeyHelp-Wartungsseite mit dem Text Das Server Control Panel ist aufgrund von Wartungsarbeiten vorübergehend nicht erreichbar](https://s-edv.com/uploads/2026/10/fd597bf7fe885657917107188ea22fd0b497d39a7b8af7717704806a1129ad20-640.png)
*Die Wartungsseite, die Kunden beim Aufruf des Panels sehen*

Wichtig für die Planung: Der Modus sperrt auch bereits angemeldete Kunden. Wir haben den Testkunden vor der Wartung angemeldet (Kunden-Dashboard 200) und dieselbe Sitzung nach dem Aktivieren erneut genutzt:

```powershell
Kunden-Dashboard mit bestehender Sitzung: 503
Das Server Control Panel ist aufgrund von Wartungsarbeiten vorübergehend nicht erreichbar.
```

Auch die Einmal-URL von `keyhelp login kunde1` führte auf die Wartungsseite (503). Dasselbe galt für `keyhelp login keyadmin`, wenn sie von einer nicht ausgenommenen Adresse aufgerufen wird. Kündigen Sie die Wartung deshalb mit Uhrzeit an, damit niemand mitten in einer Änderung ist.

> **Prüfen:** Ihr eigener Browser (ausgenommene IP) arbeitet normal weiter und zeigt den gelben Hinweis.

## Schritt 4: Was weiterläuft

Der Wartungsmodus betrifft nur das Panel. Gemessen während des aktiven Modus, alles vom Server selbst aus:

```plaintext
Website kunde1: 200
Webmail: 200
```

Auch die Zustellung lief: Eine Testmail an `info@kunde1.example.de` nach dem Aktivieren wurde zugestellt (`status=sent (250 2.0.0 <info@kunde1.example.de> ... Saved)`). Auch die Rundmail aus Schritt 1 kam an. Der FTP-Server meldete sich wie gewohnt mit `220 ProFTPD Server`. Webmail antwortete also weiter, nur die Panel-Anmeldung nicht.

> **Prüfen:** Rufen Sie vor dem Ende der Wartung eine Kunden-Website und Webmail auf. Beide sollten normal antworten.

## Schritt 5: Wartungsmodus beenden

Entfernen Sie unter „Konfiguration“, „Wartungsmodus“ den Haken „Aktiviert“ und speichern Sie. Die Meldung lautet „Die Einstellungen wurden aktualisiert.“ Die Ausnahmeliste bleibt dabei gespeichert und steht beim nächsten Mal wieder bereit.

> **Prüfen:** Die Panel-Startseite liefert wieder 200, die Ausnahmeliste bleibt erhalten:
>
> ```powershell
> 207	maintenance	excluded_ips	203.0.113.10
> 206	maintenance	is_enabled	0
> Login-Seite nach Deaktivieren im Panel: 200
> ```

Schicken Sie bei längeren Arbeiten eine kurze Entwarnung über „E-Mail an alle Benutzer“.

## Typische Fehler

**Eigene IP vergessen**

Wir haben die Liste auf eine fremde Adresse (`192.0.2.50`) geändert und gespeichert. KeyHelp warnte nicht, meldete „Die Einstellungen wurden aktualisiert.“ und zeigte schon auf der nächsten Seite im eigenen Browser „Das Server Control Panel ist aufgrund von Wartungsarbeiten vorübergehend nicht erreichbar.“ Der Wartungsmodus prüft beim Speichern nicht, ob Ihre eigene Adresse in der Liste steht.

**Rettung über die Konsole**

Starten Sie als root `keyhelp-toolbox`. Das Menü zeigt unter anderem:

```plaintext
- Available actions ------------------------------------------------------
  4)  Update IP addresses
  5)  Disable maintenance mode
  6)  Disable login restrictions for administrator accounts
  7)  Disable two-factor authentication
```

Wählen Sie `5` („Disable maintenance mode“) und bestätigen Sie mit `C` („Continue“). Die Toolbox meldete „All tasks completed.“. Danach war der Modus aus, die Ausnahmeliste aber geleert:

```powershell
id	category	name	value
207	maintenance	excluded_ips
206	maintenance	is_enabled	0
Login-Seite: 200
```

Tragen Sie Ihre Adresse vor dem nächsten Einschalten also neu ein.

**Ungültiger Eintrag in der Liste**

Ein Eintrag wie „keine-ip“ wird mit „Ungültige IP / IP Subnetzadresse.“ abgelehnt.

**Dynamische IP**

Wechselt Ihre Adresse während der Wartung, sperren Sie sich ebenfalls aus. Laut Seitentext sind auch IP-Bereiche möglich. Halten Sie in jedem Fall die Konsole bereit.

## Häufige Fragen

### Kann ich den Text der Wartungsseite ändern?

Auf der Seite „Wartungsmodus“ gibt es dafür kein Feld. „Benutzerdefinierte UI-Benachrichtigungen“ ist in unserer Installation als „Pro-Feature“ markiert und nicht nutzbar.

### Sind Websites während der Wartung offline?

Nein. Kunden-Website und Webmail antworten mit 200, Mails werden zugestellt.

### Kann der Admin vom Server aus mit `keyhelp login` hinein?

Nicht von einer Adresse außerhalb der Liste: Die Einmal-URL von `keyhelp login keyadmin` führte von 127.0.0.1 (nicht in der Liste) auf die Wartungsseite.

### Wie plane ich den Ablauf am besten?

Aus den Testergebnissen leiten wir diese Reihenfolge ab: Rundmail mit Datum und Uhrzeit verschicken, eigene IP auf der Seite „Wartungsmodus“ mit der angezeigten Adresse abgleichen, Modus aktivieren, von einer zweiten Verbindung (zum Beispiel Mobilfunk) die 503-Seite prüfen, arbeiten, Modus abschalten, Anmeldung von außen prüfen. Halten Sie während der gesamten Zeit eine Root-Konsole offen.

### Lässt sich die Wartung zeitgesteuert ein- und ausschalten?

In der Oberfläche haben wir dafür keine Option gefunden, nur den Haken „Aktiviert“.

## Fazit

Der Wartungsmodus ist ein einfacher Schalter mit klarer Wirkung: Das Panel ist für alle außer Ihren Adressen zu, Websites, Webmail und Mail laufen weiter. Weil er auch angemeldete Kunden sofort aussperrt und keinen eigenen Text kennt, gehört die Ankündigung per „E-Mail an alle Benutzer“ dazu. Prüfen Sie vor dem Speichern, dass Ihre aktuelle IP in der Liste steht, und halten Sie für den Notfall die Konsole mit `keyhelp-toolbox` bereit.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp: Debian 12 auf 13 upgraden](https://s-edv.com/anleitungen/keyhelp-debian-12-auf-13-upgrade-skript-pruefliste)
- [KeyHelp-Backup extern mit Restic einrichten](https://s-edv.com/anleitungen/keyhelp-backup-extern-restic-restore-einrichten)
- [Keyweb: KeyHelp, alle Funktionen im Überblick](https://www.keyweb.de/de/keyhelp/keyhelp/alle-funktionen-im-ueberblick)
