Betrieb
Backup und Wiederherstellung
Ein vollständiges Backup braucht drei Bestandteile. Fehlt einer, ist die Wiederherstellung unvollständig:
- Datenbank — Konten, Einstellungen, Seiten, Warteschlange.
storage/app/— Logo, eigenes Theme..env— enthältAPP_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_PREFIXgesetzt, 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
.envNICHT — und damit nicht denAPP_KEY. Die Spaltentwo_factor_secretundtwo_factor_recovery_codessind mit ihm verschlüsselt. Wer die Datenbank ohne die passende.envzurückspielt, hat eine Installation, in die niemand mit zweitem Faktor mehr hineinkommt. Sichere die.envimmer 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.