Shopware Backup erstellen

1. Was ein vollständiges Shopware-Backup enthalten muss

2. Geeigneten Sicherungszeitpunkt wählen

Während des Backups können Bestellungen, Zahlungen oder Änderungen entstehen. Für Wartungsarbeiten und Updates sollte deshalb ein ruhiger Zeitraum oder ein kontrolliertes Wartungsfenster gewählt werden.

• Vor jedem Shopware-Update
• Vor Plugin- und Theme-Updates mit Datenbankänderungen
• Vor Migrationen und Importen
• Vor direkten Datenbankänderungen
• Vor Serverumzügen
• Vor umfangreichen Konfigurationsänderungen
• Regelmäßig als automatisches Betriebsbackup

3. Vorbereitung und Speicherplatz prüfen

Shopware-Version dokumentieren

bin/console --version

/usr/bin/php bin/console --version

Freien Speicherplatz prüfen

df -h

Größe des Shopware-Verzeichnisses ermitteln

du -sh /pfad/zum/shopware-verzeichnis

Backup-Verzeichnis mit Zeitstempel anlegen

BACKUP_DIR="/pfad/zu/backups/shopware-$(date +%Y-%m-%d_%H-%M-%S)"
mkdir -p "$BACKUP_DIR"
echo "$BACKUP_DIR"

4. Shopware-Datenbank sichern

Die Zugangsdaten befinden sich bei aktuellen Shopware-Installationen typischerweise in der Datei .env.local. Kennwörter sollten nicht direkt in der Shell-Historie hinterlegt werden.

MySQL- beziehungsweise MariaDB-Dump erstellen

mysqldump \
  --single-transaction \
  --quick \
  --routines \
  --triggers \
  --default-character-set=utf8mb4 \
  -h DATENBANK_HOST \
  -u DATENBANK_BENUTZER \
  -p \
  DATENBANK_NAME \
  | gzip > "$BACKUP_DIR/database.sql.gz"

Host, Benutzer und Datenbankname müssen durch die Werte der jeweiligen Installation ersetzt werden. Das Kennwort wird nach dem Start sicher abgefragt.

5. Shopware-Dateien sichern

Das Datei-Backup muss mindestens den Projektstand, Plugins, Themes, Medien, Composer-Dateien und Konfigurationen enthalten.

Vollständiges Archiv erstellen

tar \
  --exclude="./var/cache" \
  --exclude="./var/log" \
  -czf "$BACKUP_DIR/shopware-files.tar.gz" \
  -C /pfad/zum/shopware-verzeichnis \
  .

Cache- und Logdateien können bei einer Wiederherstellung neu erzeugt werden. Ob weitere Verzeichnisse ausgeschlossen werden dürfen, hängt von der konkreten Installation ab.

6. Medien, Downloads und Dokumente prüfen

Produktbilder, Erlebniswelt-Dateien, Downloads und weitere Medien liegen im Dateisystem beziehungsweise in einem konfigurierten externen Dateispeicher.

• Verzeichnis public/media vorhanden
• Verzeichnis public/thumbnail geprüft
• Private Dateien und Dokumente berücksichtigt
• Externer S3- oder Objektspeicher separat gesichert
• Produktdownloads und digitale Inhalte geprüft
• Individuelle Upload-Verzeichnisse dokumentiert

7. Konfiguration und Zugangsdaten sichern

• .env und .env.local
• composer.json und composer.lock
• Verzeichnis config
• Verzeichnis custom/plugins
• Verzeichnis custom/apps
• Individuelle Themes und Anpassungen
• Webserver-Konfiguration
• Cronjobs, Supervisor- und systemd-Konfiguration
• SSL-, CDN- und Proxy-Einstellungen
• Externe API- und Zahlungsanbieter-Konfiguration

8. Konsistentes Backup für Wartungsarbeiten erstellen

Für Updates oder größere technische Eingriffe empfiehlt sich ein kurzes Wartungsfenster. Dadurch entstehen zwischen Datenbank- und Datei-Backup keine neuen Bestellungen oder Änderungen.

Verkaufskanäle in Wartung setzen

bin/console sales-channel:maintenance:enable --all

Empfohlene Reihenfolge

1. Wartungsmodus aktivieren.
2. Laufende Importe und Hintergrundprozesse beenden lassen.
3. Datenbankdump erstellen.
4. Dateiarchiv erstellen.
5. Prüfsummen erzeugen.
6. Backup an sicheren Speicherort kopieren.
7. Geplante Wartungsarbeit durchführen.
8. Shop vollständig prüfen.
9. Wartungsmodus deaktivieren.

Wartungsmodus beenden

bin/console sales-channel:maintenance:disable --all

9. Backup direkt nach der Erstellung prüfen

Dateien im Backup-Verzeichnis anzeigen

ls -lh "$BACKUP_DIR"

Gzip-Datenbankdump prüfen

gzip -t "$BACKUP_DIR/database.sql.gz"

Tar-Archiv auflisten

tar -tzf "$BACKUP_DIR/shopware-files.tar.gz" | head -n 50

Prüfsummen erzeugen

cd "$BACKUP_DIR"
sha256sum database.sql.gz shopware-files.tar.gz > SHA256SUMS

Prüfsummen kontrollieren

cd "$BACKUP_DIR"
sha256sum -c SHA256SUMS

10. Backups sicher aufbewahren

• Mindestens eine Kopie außerhalb des Webservers
• Getrennter Backup-Speicher oder anderer Anbieter
• Verschlüsselte Übertragung
• Verschlüsselte Speicherung sensibler Daten
• Zugriff nur für berechtigte Personen
• Aufbewahrungsfristen dokumentiert
• Regelmäßige Löschung abgelaufener Sicherungen
• Erfolgreiche Backup-Läufe überwacht

11. Regelmäßige Shopware-Backups automatisieren

Automatische Backups sollten Datenbank und Dateien nach einem festen Zeitplan sichern, Prüfsummen erzeugen, alte Sicherungen kontrolliert löschen und Fehler melden.

• Täglicher Datenbankdump
• Regelmäßiges vollständiges Datei-Backup
• Bei Bedarf inkrementelle Dateisicherungen
• Externer Speicherort
• Aufbewahrung mehrerer Generationen
• Fehlerbenachrichtigung
• Regelmäßiger Restore-Test

12. Wiederherstellung in einer Testumgebung prüfen

Der sicherste Nachweis eines funktionierenden Backups ist eine Wiederherstellung in einer getrennten Testumgebung.

• Leere Testdatenbank anlegen.
• Dateiarchiv in ein getrenntes Verzeichnis entpacken.
• Datenbankdump importieren.
• Test-Konfiguration und Test-Domain eintragen.
• Produktiven Mailversand deaktivieren.
• Cache neu aufbauen.
• Administration und Storefront prüfen.
• Produkte, Kunden, Bestellungen und Medien stichprobenartig kontrollieren.

13. Abschlusskontrolle

• Shopware-Version und Sicherungszeitpunkt dokumentiert
• Datenbankdump vollständig erstellt
• Shopware-Dateien vollständig archiviert
• Medien und externe Speicher berücksichtigt
• Composer-Dateien gesichert
• Konfiguration und Worker-Einstellungen gesichert
• Backup liegt außerhalb des öffentlichen Webverzeichnisses
• Datenbankdump ist technisch lesbar
• Dateiarchiv lässt sich auflisten
• Prüfsummen stimmen
• Externe Backup-Kopie vorhanden
• Zugriff und Verschlüsselung geprüft
• Aufbewahrungsfrist festgelegt
• Wiederherstellung wurde testweise geprüft

Häufige Fragen

Verwandte Shopware-Anleitungen