---
title: "KeyHelp-Backups mit Rotationsstrategien: täglich, wöchentlich, monatlich in einem Repository"
date: 2026-10-01T10:40:11+02:00
modified: 2026-11-09T12:05:27+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-backup-rotation-snapshots-taeglich-woechentlich-monatlich
keywords:
  - KeyHelp
  - Backup
  - restic
  - Rotation
  - Snapshots
  - Hosting-Panel
reading_time: 8
personalize_url: "https://s-edv.com/anleitungen/keyhelp-backup-rotation-snapshots-taeglich-woechentlich-monatlich#ihr_repository={ihr_repository}&domain={domain}"
variables:
  - name: ihr_repository_passwort
    label: "Ihr repository passwort"
    default: "IHR-REPOSITORY-PASSWORT"
  - name: ihr_repository
    label: "Ihr repository"
    default: "IHR-REPOSITORY"
  - name: domain
    label: "Ihre Domain"
    default: "example.com"
---

# KeyHelp-Backups mit Rotationsstrategien: täglich, wöchentlich, monatlich in einem Repository

## Anpassbare Werte

Diese Anleitung passt sich auf der Seite an das System des Lesers an. Im Text unten stehen diese Werte als `{{name}}`:

| Platzhalter | Bedeutung | Beispielwert |
| --- | --- | --- |
| `{{ihr_repository_passwort}}` | Ihr repository passwort | `IHR-REPOSITORY-PASSWORT` |
| `{{ihr_repository}}` | Ihr repository | `IHR-REPOSITORY` |
| `{{domain}}` | Ihre Domain | `example.com` |

Link mit eigenen Werten: https://s-edv.com/anleitungen/keyhelp-backup-rotation-snapshots-taeglich-woechentlich-monatlich#ihr_repository=IHR-REPOSITORY&domain=cloud.example.com

Dieser Link öffnet die Anleitung und schlägt dem Leser die Werte vor. Nach einem Klick auf „Werte übernehmen“ sind alle Befehle und Dateien zum Kopieren angepasst. Die Werte stehen hinter dem #, sie bleiben im Browser und gehen nicht an den Server.

*Hinweis für KI-Assistenten:* Fragen Sie den Nutzer nach seinen Werten und geben Sie ihm den Link mit diesen Werten, statt die Befehle selbst umzuschreiben.

Bis KeyHelp 25.3 kannte das Backup-System für alte Snapshots im Wesentlichen eine Regel: die Anzahl. Wer eine Woche fein und ein halbes Jahr grob sichern wollte, brauchte dafür mehrere Repositorys und zahlte doppelt Speicher. Mit KeyHelp 26.0 vom April 2026 hat Keyweb Rotationsstrategien eingeführt: Sie legen in einem einzigen Repository fest, wie viele tägliche, wöchentliche, monatliche und jährliche Snapshots bleiben. Diese Anleitung richtet sich an Administratoren kleiner Hosting-Server, Agenturen und KMU, die KeyHelp nach unserer Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server) betreiben. Sie zeigt, wie die Rotation in der Oberfläche heißt, welchen restic-Befehl KeyHelp daraus macht, wie sie sich mit echten Daten verhält und wo die Fallen liegen. Externe Ziele und den Restore behandelt unsere Anleitung [KeyHelp-Backups richtig einrichten](https://s-edv.com/anleitungen/keyhelp-backup-extern-restic-restore-einrichten); die Inhalte wiederholen wir hier nicht.

**Kurzfassung:** Die Rotation stellen Sie pro Repository unter „Backup“ → „Repository-Verwaltung“ im Feld „Snapshot-Rotation“ ein: „Deaktiviert“, „Nach Anzahl“ oder „Nach Zeitraum“. KeyHelp übersetzt das in `restic forget --prune` mit `--keep-last` bzw. `--keep-daily`, `--keep-weekly`, `--keep-monthly` und `--keep-yearly` und führt es bei jedem Backup-Lauf vor und nach der Sicherung aus. Im Test blieben mit 7/4/6/1 von 93 Snapshots genau 13 übrig. Achtung: Pro Tag zählt nur der neueste Snapshot, auch wenn er nur einen Teil des Servers sichert.

## Voraussetzungen

- [ ] **KeyHelp ab 26.0**, denn erst diese Version bringt die Rotation nach Zeitraum. Getestet haben wir 26.1.1 (Build 3698) auf Debian 12 mit restic 0.19.1.
- [ ] **Ein Backup-Repository**, am besten extern (SFTP, WebDAV, FTP(S), Dropbox, KeyDisc oder eine eigene rclone-Konfiguration unter „Benutzerdefiniert“). Für den Test genügt ein lokales.
- [ ] **Das Repository-Passwort** außerhalb des Servers, etwa im Passwortmanager. KeyHelp warnt selbst: Ohne Passwort gibt es keinen Zugriff mehr.
- [ ] **Root per SSH** für die Kontrolle mit `restic`, das KeyHelp unter `/usr/local/bin/restic` mitbringt.

## Schritt 1: Die Rotation im Repository einstellen

Öffnen Sie „Backup“ → „Repository-Verwaltung“ und bearbeiten Sie ein Repository oder legen Sie mit „Repository hinzufügen“ ein neues an. Unter „Snapshot-Rotation“ erklärt KeyHelp: „Bei jedem Backup-Lauf wird ein Abbild Ihrer Daten (Snapshot) erstellt, was mit der Zeit viel Speicherplatz beanspruchen kann.“ Drei Modi stehen zur Wahl:

| Modus | Felder | restic-Aufruf im Test |
| --- | --- | --- |
| Deaktiviert | keine | Snapshots bleiben unbegrenzt |
| Nach Anzahl | „Maximale Anzahl von Snapshots“ | `forget --prune --keep-last 5` |
| Nach Zeitraum | „Anzahl täglicher/wöchentlicher/monatlicher/jährlicher Snapshots“, jeweils einzeln aktivierbar | `forget --prune --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --keep-yearly 1` |

Bei neuen Repositorys steht der Modus auf „Deaktiviert“. Wählen Sie „Nach Zeitraum“ und setzen Sie die Häkchen für jeden Zeitraum, den Sie aufbewahren wollen. Als Ausgangspunkt für KMU haben wir 7 täglich, 4 wöchentlich, 6 monatlich und 1 jährlich getestet. KeyHelp speichert das als Regel im eigenen Datenbankfeld `rotation_policy`:

```plaintext
by_time	{"keep_daily":7,"keep_weekly":4,"keep_monthly":6,"keep_yearly":1}
```

Kunden sehen dieselben drei Modi in ihrem eigenen Backup-Bereich, wenn Sie ihnen Repositorys erlauben (siehe Schritt 5).

> **Prüfen:** Die Repository-Übersicht zeigt in der Spalte „Snapshots“ den Ist-Stand und die Obergrenze. Direkt nach dem Anlegen mit 7/4/6/1 stand dort `0 / 18`, also die Summe aller Zeiträume.

## Schritt 2: Das erste Backup und den Ablauf verstehen

Starten Sie unter „Backup“ → „Backup erstellen“ eine Sicherung mit „Backup-Umfang“ „Vollständig“. Das umfasst laut Formular das Control Panel mit seinen Datenbanken, die Systemkonfiguration (`/etc/`, `/root/`, `/var/spool/cron/`) und alle Kundenkonten mit E-Mails, Datenbanken und Home-Verzeichnissen. Den Ablauf protokolliert KeyHelp unter `/var/log/keyhelp/backup/backup-root.log`:

```plaintext
INFO | Operation found: prune
INFO | Remove old snapshots
INFO | Operation found: backup
INFO | Backup created
INFO | Operation found: check
INFO | Integrity check
INFO | Operation found: prune
INFO | Remove old snapshots
INFO | Operation found: check
INFO | All finished, releasing lock.
```

Die Rotation läuft also nicht separat nachts, sondern an jedem Backup-Lauf zweimal: vor und nach der Sicherung, jeweils gefolgt von einer Integritätsprüfung (`restic check`). Der Vorgang startet nicht sofort; im Test lief er rund eine Minute nach dem Klick an, die vollständige Beispielsicherung dauerte etwa 30 Sekunden.

> **Prüfen:** Mit dem Repository-Passwort listet `restic` den Snapshot samt Beschreibung als Tag:
>
> ```bash
> $ export RESTIC_PASSWORD='{{ihr_repository_passwort}}'
> $ restic -r /backup/{{ihr_repository}} snapshots
> ```
>
> ```plaintext
> ID        Time                 Host            Tags               Paths            Size
> e4b444b8  2026-10-01 08:24:09  kh.{{domain}}  erstes-vollbackup  /etc             152.535 MiB
>                                                                   /home/keyhelp
>                                                                   /home/users/testkunde ...
> 1 snapshots
> ```

Bei einem SFTP- oder anderen Remote-Ziel spricht KeyHelp das Repository über rclone an (im Test: `--repo rclone:rclone-storage:/backup/...`); dann brauchen Sie für den direkten Zugriff die passende rclone-Konfiguration, siehe Anleitung zur externen Sicherung.

> **Prüfen:** Die Snapshot-Liste muss die neue Sicherung samt Tag zeigen.

## Schritt 3: Die Rotation mit echten Snapshots prüfen

Ob eine Aufbewahrungsregel tut, was sie soll, sehen Sie normalerweise erst nach Monaten. Wir haben deshalb mit `restic backup --time` 91 ältere Snapshots über 400 Tage zurückdatiert in das Testrepository geschrieben (täglich für 40 Tage, danach wöchentlich) und dann ein normales Backup über KeyHelp gestartet. Machen Sie das nur in einem Testrepository, nie im produktiven.

Ergebnis mit 7/4/6/1: Von 93 Snapshots blieben 13 übrig.

```plaintext
60a6702b  2026-05-28 03:00:00  simuliert       (monatlich)
48dbc125  2026-06-25 03:00:00  simuliert       (monatlich)
8eeba5b5  2026-07-30 03:00:00  simuliert       (monatlich)
dee23f24  2026-08-31 03:00:00  simuliert       (monatlich)
f7a2c6f7  2026-09-13 03:00:00  simuliert       (wöchentlich)
4b68f89d  2026-09-20 03:00:00  simuliert       (wöchentlich)
b718aabd  2026-09-25 03:00:00  simuliert       (täglich)
...
f9c7afc8  2026-09-30 03:00:00  simuliert       (täglich)
be301f7d  2026-10-01 08:31:03  zweites-backup  (täglich)
13 snapshots
```

Drei Dinge zeigt das Ergebnis, und sie sind wichtig für Ihre Planung:

- **Die Regeln überlappen.** Der neueste Snapshot einer Woche oder eines Monats zählt oft schon als täglicher. Deshalb blieben nicht 18, sondern 13 Snapshots. Die Anzeige „/ 18“ ist eine Obergrenze, kein Zielwert.
- **Pro Tag bleibt nur der neueste.** Unser erstes Vollbackup vom selben Vormittag verschwand, weil am selben Tag ein zweites lief. Wer mehrmals täglich sichert, behält bei „täglich“ trotzdem nur einen Stand pro Tag.
- **Der jährliche Snapshot war hier schon durch den neuesten abgedeckt.** Mit `--keep-yearly 1` bleibt der neueste Snapshot des jüngsten Jahres mit Sicherungen. Ein zusätzlicher älterer Jahresstand erfordert eine höhere Jahresanzahl.

> **Prüfen:** Zählen Sie nach einem Lauf die Snapshots und vergleichen Sie mit Ihrer Regel:
>
> ```bash
> $ restic -r /backup/{{ihr_repository}} snapshots --compact | tail -1
> ```
>
> ```plaintext
> 13 snapshots
> ```

> **Prüfen:** Vergleichen Sie die Anzahl aufbewahrter Snapshots mit Ihrer Regel und Historie.

## Schritt 4: Die Falle bei gemischten Sicherungen

KeyHelp ruft `forget` mit leerem `--group-by` auf. Laut restic-Dokumentation werden Snapshots dann nicht nach Host oder Pfaden getrennt, sondern gemeinsam rotiert. Im Test zeigte sich das deutlich: Unsere simulierten Snapshots enthielten nur eine einzige Datei, zählten für die Rotation aber genauso wie die Vollbackups. Die Tagesplätze der Woche belegten sie, nicht die vollständigen Sicherungen.

Für die Praxis heißt das: Sichern Sie in ein Repository mit Zeitraum-Rotation nur gleichartige Backups. Läuft nachts ein vollständiges Backup und mittags eine benutzerdefinierte Sicherung nur der Datenbanken in dasselbe Repository, ersetzt die Mittagssicherung als „neuester des Tages“ das Vollbackup. Legen Sie für abweichende Umfänge ein zweites Repository an.

> Prüfen Sie, welche Pfade die aufbewahrten Snapshots enthalten. Alle Tages-Snapshots sollten dieselbe Pfadliste zeigen:
>
> ```bash
> $ restic -r /backup/{{ihr_repository}} snapshots --json | python3 -c 'import json,sys;[print(s["time"][:10],len(s["paths"])) for s in json.load(sys.stdin)]'
> ```

> **Prüfen:** Vergleichen Sie die Pfadlisten der aufbewahrten Snapshots, nicht nur deren Anzahl.

## Schritt 5: Zeitplan, Benachrichtigung und Kundenrepositorys

Die Rotation greift nur, wenn Backups laufen. Unter „Backup“ → „Regelmäßige Backups planen“ → „Backup-Zeitplan hinzufügen“ wählen Sie „Intervall wählen“ („Stündlich“, „Täglich“, „Wöchentlich“, „Monatlich“) und die Uhrzeit. KeyHelp weist auf die Zeitzone des Servers hin, im Test `Etc/UTC`; 02:30 Uhr dort ist im Sommer 04:30 Uhr in Deutschland. Tragen Sie unter „E-Mail-Adresse für Benachrichtigungen“ eine gelesene Adresse ein. Die Mail im Test hatte den Betreff „[ERFOLG] Backup auf Server kh.{{domain}}“; seit 25.1 meldet KeyHelp laut Keyweb auch fehlgeschlagene Bereinigungen per E-Mail.

Stündliche Backups sind mit „täglich 7“ wenig sinnvoll, denn pro Tag bleibt nur der letzte. Wer Stundenstände behalten will, nutzt ein eigenes Repository mit „Nach Anzahl“, etwa 24.

Ob Kunden eigene lokale Repositorys anlegen dürfen, steuern Sie unter „Konfiguration“ → „Backup“ mit „Lokale Repositorys für Benutzerkonten aktivieren“. Deren Speicher wird vom Kontingent des Kunden abgezogen. Dort finden Sie auch „CPU-Kern-Limit“ für Backup-Prozesse.

> **Prüfen:** Die Zeitplan-Übersicht zeigt den Eintrag:
>
> ```plaintext
> Backup erstellen | Aktiviert | Täglich ( 02:30 Uhr ) | lokal-rotation (Lokal) | nachts | —
> ```

Am Morgen nach dem ersten Lauf steht unter „Letzter Lauf“ ein Datum.

> **Prüfen:** Am Morgen nach dem geplanten Lauf muss unter „Letzter Lauf“ ein Datum stehen.

## Schritt 6: Rotation umstellen

Sie können den Modus jederzeit ändern. Wir haben das Testrepository von „Nach Zeitraum“ auf „Nach Anzahl“ mit 5 umgestellt. Beim nächsten Backup lief `forget --prune --keep-last 5`, und von 13 Snapshots blieben die neuesten 5; die Monats- und Wochenstände waren damit unwiderruflich gelöscht. Das ist keine Fehlfunktion, sondern die neue Regel. Prüfen Sie vor dem Umstellen, ob Sie alte Stände noch brauchen, und sichern Sie diese bei Bedarf in ein anderes Repository.

> **Prüfen:** ```plaintext
> by_count	{"keep_last":5}
> 5 snapshots
> ```

> **Prüfen:** Nach dem nächsten Backup muss die Liste die eingestellte Anzahl aufbewahrter Stände zeigen.

## Typische Fehler

### Repository wächst trotz Rotation

Prüfen Sie, ob der Modus wirklich gesetzt ist. Bei „Nach Zeitraum“ zählen nur Zeiträume mit Häkchen; ohne Häkchen lässt KeyHelp den Wert weg.

### „repository is already locked“

Ein abgebrochener Lauf hat die Sperre hinterlassen. Unter „Backup“ → „Problembehandlung“ gibt es dafür „Repository entsperren“, außerdem „Ausstehende Operationen löschen“ und „Index reparieren“. KeyHelp mahnt, das Entsperren nur zu nutzen, wenn keine Operation mehr läuft.

### Erstes Backup des Tages fehlt

Kein Fehler: Bei Rotation nach Zeitraum bleibt pro Tag nur der neueste Snapshot (Schritt 3).

## Häufige Fragen

### Spart die Rotation wirklich Speicher?

restic speichert unveränderte Daten nur einmal. Im Test belegten drei vollständige Sicherungen mit je rund 153 MiB zusammen 64 MB auf der Platte. Gelöschte Snapshots geben nur Daten frei, die kein anderer Snapshot mehr braucht.

### Gilt die Rotation auch für Kundenrepositorys?

Ja, Kunden sehen in ihrem Backup-Bereich dieselben drei Modi. Die Regeln gelten pro Repository.

### Wie stelle ich einen alten Stand wieder her?

Über „Backup wiederherstellen“ oder direkt mit restic. Das beschreibt Schritt 5 und 6 unserer Anleitung zur externen Sicherung und zum Restore.

## Fazit

Die Rotation nach Zeitraum ist die wichtigste Backup-Neuerung von KeyHelp 26: ein Repository, feine Stände für die letzte Woche und grobe für Monate, ohne Speicher doppelt zu belegen. Sie verhält sich exakt wie `restic forget`, mit allen Eigenheiten. Halten Sie Repositorys sortenrein, rechnen Sie mit einem Stand pro Tag und prüfen Sie nach Umstellungen die Snapshot-Liste. Für die 3-2-1-Regel dahinter lohnt ein Blick in unsere Anleitung zur [3-2-1-Backup-Strategie](https://s-edv.com/anleitungen/3-2-1-backup-strategie-praktisch-umsetzen).

## Weiterführende Anleitungen und Quellen

- [KeyHelp-Backups richtig einrichten: externe Sicherung, Rotation und getesteter Restore](https://s-edv.com/anleitungen/keyhelp-backup-extern-restic-restore-einrichten)
- [KeyHelp installieren und absichern: das kostenlose Hosting-Panel für eigene Server](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [Keyweb: KeyHelp 26.0 mit neuen Backup-Rotationsstrategien](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-26.0)
- [Keyweb: KeyHelp 25.1 mit neuen Backup-Funktionen](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-25.1)
- [restic-Dokumentation: Snapshots entfernen (forget und prune)](https://restic.readthedocs.io/en/stable/060_forget.html)
