Betrieb

Backup und Wiederherstellung

Ein vollständiges Backup braucht drei Bestandteile. Fehlt einer, ist die Wiederherstellung unvollständig:

  1. Datenbank — Konten, Einstellungen, Seiten, Warteschlange.
  2. storage/app/ — Logo, eigenes Theme.
  3. .env — enthält APP_KEY.
# Datenbank
mysqldump --single-transaction --quick -u <user> -p <db> | gzip > db-$(date +%F).sql.gz

# Ablagen
tar czf storage-$(date +%F).tar.gz -C /pfad/zu/formrelay storage/app

Ohne APP_KEY sind das gespeicherte SMTP-Passwort, verschlüsselte Sitzungen und die Zwei-Faktor-Geheimnisse unlesbar.

Der Knopf in der Oberfläche: Einstellungen → Wartung

Unter Einstellungen → Wartung liegt oben „Datenbank herunterladen". Er liefert je Treiber:

Treiber Datei Inhalt
SQLite formrelay-datenbank-2026-09-01-1530.sqlite die Datenbankdatei selbst, über VACUUM INTO als abgeschlossener Stand
MySQL / MariaDB formrelay-datenbank-2026-09-01-1530.sql SQL-Text: DROP TABLE + CREATE TABLE + INSERT, gelesen in einem Snapshot (REPEATABLE READ)

Er ist der Handgriff vor einem Eingriff — vor dem Aufräumen, vor einem Update. Er ist kein Ersatz für die regelmäßige Sicherung oben.

Der Dump entsteht in PHP, ohne mysqldump und ohne Shell-Aufruf. Er funktioniert also auch auf Hosts, die exec sperren.

  • Nur die Tabellen dieser Installation. Ist DB_PREFIX gesetzt, werden ausschließlich Tabellen mit diesem Präfix gesichert. Ohne Präfix werden alle Tabellen des Schemas gesichert — auch die fremder Anwendungen in einer geteilten Datenbank.
  • Gelesen wird in Blöcken (500 Zeilen) und der Text als Strom ausgeliefert. Der Speicherbedarf bleibt damit unabhängig von der Größe der Tabellen.
  • PostgreSQL und SQL Server werden nicht bedient. Der Knopf erscheint dann nicht; stattdessen steht ein Hinweis auf die Werkzeuge des Datenbanksystems.

Die Datei ist selbst ein personenbezogener Datenbestand. Sie enthält Konten mit Passwort-Hashes und Sitzungen mit IP-Adressen. Verschlüsselt aufbewahren, nicht in einen geteilten Ordner legen, nach Gebrauch löschen.

Sie enthält die .env NICHT — und damit nicht den APP_KEY. Die Spalten two_factor_secret und two_factor_recovery_codes sind mit ihm verschlüsselt. Wer die Datenbank ohne die passende .env zurückspielt, hat eine Installation, in die niemand mit zweitem Faktor mehr hineinkommt. Sichere die .env immer zusammen mit der Datenbank.

Scheitert die Sicherung, steht der Grund im Protokoll (storage/logs). Die häufigsten Ursachen sind fehlender Platz und fehlendes Schreibrecht im Temp-Verzeichnis des Servers.

Wiederherstellung

gunzip < db-2026-08-14.sql.gz | mysql -u <user> -p <db>
tar xzf storage-2026-08-14.tar.gz -C /pfad/zu/formrelay
php artisan storage:link
php artisan config:cache

Danach prüfen: Anmeldung (auch mit zweitem Faktor), Test-Mail, Logo, und Einstellungen → Systemdaten (Schreibrechte, Warnungen).

Teste die Wiederherstellung, bevor du sie brauchst. Ein Backup, das nie zurückgespielt wurde, ist eine Annahme, keine Sicherung.

Quelle dieser Seite: docs/betrieb/backup.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die Markdown-Datei, nicht in diese Seite.