So sichern Sie einen Neo4j-Docker-Container (2026)
Neo4j braucht einen konsistenten Dump, bevor restic ins Spiel kommt. Dockstash führt `neo4j-admin database dump neo4j --to-path=/backup` im Container aus, fängt die Ausgabe ab und speichert sie verschlüsselt off-site — /data wird nie im laufenden Betrieb kopiert, denn neo4j-admin dump (oder das Enterprise-Online-Backup) erzeugt einen konsistenten Store-Schnappschuss, denn Graph-Store und Transaktionslogs werden kontinuierlich geschrieben.
Was Dockstash erkennt
| Erkannte Env-Keys | NEO4J_AUTH, NEO4J_dbms_default__database, NEO4J_PLUGINS |
|---|---|
| Standard-Port | 7687 |
| Live-Datenpfade (nie im Betrieb kopiert) | /data, /data/databases, /data/transactions |
| Beispiel-Images | neo4j:5, neo4j:5-community, neo4j:5-enterprise, neo4j |
Neo4j mit Dockstash sichern, Schritt für Schritt
Dockstash-Konto anlegen und das Dashboard öffnen
Registrieren Sie sich kostenlos auf app.dockstash.com/register. Der einmalige Einrichtungsassistent fragt nach Ihrem Storage-VPS (der Maschine, die die verschlüsselten Backups aufnimmt) und generiert ein Verschlüsselungspasswort — speichern Sie es sofort in einem Passwort-Manager, es wird genau einmal angezeigt.
Das Docker-Projekt mit Neo4j hinzufügen
Auf dem Projects-Bildschirm erkennt Dockstash automatisch jeden Compose-Projektordner des Servers (standardmäßig unter /var/www). Wählen Sie das Projekt mit Ihrem Neo4j-Service. Noch wird nichts gesichert — Sie sagen Dockstash nur, wo das Projekt liegt.
Prüfen, dass Neo4j erkannt wurde
Öffnen Sie das Projekt und schauen Sie auf den Plan-Tab. Dockstash liest docker-compose.yml, erkennt das neo4j-Image und vermerkt den aufgelösten Container sowie die gefundenen Env-Keys (NEO4J_AUTH, NEO4J_PLUGINS). Dateien, Datenbanken und Proxy-Configs lassen sich vor dem Speichern umschalten.
Verstehen, wie der Neo4j-Dump funktioniert
Neo4j ist die eine Engine, bei der die Edition zählt. Enterprise unterstützt heiße Online-Backups mit neo4j-admin database backup, während die Datenbank weiterläuft. Community verlangt für neo4j-admin database dump eine gestoppte Datenbank — das sichere Muster ist ein kurzer geplanter Stopp zur ruhigsten Stunde oder der Dump einer Sekundärinstanz. Dockstash erfasst das entstehende Dump-Artefakt, nie das laufende /data-Verzeichnis.
Speicherziel bestätigen
Backups liegen als verschlüsselte restic-Snapshots auf Ihrem eigenen Storage-VPS, übertragen per SSH. Haben Sie den Assistenten abgeschlossen, ist das bereits konfiguriert; Host, Benutzer, Port oder SSH-Key ändern Sie jederzeit unter Settings → Storage.
Backup-Zeitplan festlegen
Wählen Sie im Schedule-Tab täglich, wöchentlich oder einen eigenen Cron-Ausdruck (inline validiert). Für Community-Neo4j planen Sie das Backup in die ruhigste Stunde, damit das kurze Dump-Fenster schmerzlos bleibt. Ergänzen Sie einen wöchentlichen Prune-Zeitplan mit Ihrer Aufbewahrungsrichtlinie.
Das erste Backup jetzt ausführen
Klicken Sie auf Backup Now auf der Projektkarte. Dockstash erfasst den Graph-Dump und die Projektdateien und streamt alles in restic — die Live-Ausgabe verfolgen Sie Zeile für Zeile im Log-Panel.
Snapshot bestätigen
Nach dem Lauf zeigt die Projektkarte die neue letzte Backup-Zeit, die Snapshot-Anzahl und die Repository-Größe. Öffnen Sie den Snapshots-Bildschirm: Der Wiederherstellungspunkt erscheint in der Zeitleiste — Ihr Beweis, dass das Backup off-site angekommen ist.
Der Dump-Befehl
neo4j-admin database dump neo4j --to-path=/backupDer Restore-Befehl
neo4j-admin database load neo4j --from-path=/backup --overwrite-destination=trueneo4j-admin dump (oder das Enterprise-Online-Backup) erzeugt einen konsistenten Store-Schnappschuss, denn Graph-Store und Transaktionslogs werden kontinuierlich geschrieben.
Ein Neo4j-Backup wiederherstellen und beweisen, dass es funktioniert
Ein Neo4j-Backup wird erst real, wenn es wieder in einen abfragbaren Graphen geladen wurde. Dockstash-Restores überschreiben Ihre Live-Datenbank standardmäßig nie — Sie stellen zuerst an einen frischen Ort wieder her, laden in eine Testinstanz und befördern bewusst.
Wiederherstellungspunkt wählen
Öffnen Sie Snapshots, wählen Sie das Projekt und durchstöbern Sie die Zeitleiste. Jede Zeile enthält ein konsistentes neo4j-admin-Dump-Artefakt plus die Projektdateien desselben Laufs.
An einen neuen Ort wiederherstellen
Klicken Sie auf Restore und behalten Sie den Standardmodus „Restore to new location". Tippen Sie den Projektnamen zur Bestätigung. Dump-Artefakt und Dateien landen im gewählten Zielpfad; das Live-Projekt bleibt unberührt.
Wiederhergestellten Graphen laden und prüfen
Starten Sie einen Neo4j-Testcontainer (gleiches Image und gleiche Plugins wie in Produktion), laden Sie den Dump mit neo4j-admin database load gegen das gestoppte Ziel, starten Sie und prüfen Sie mit ein paar Cypher-Abfragen — Knoten- und Beziehungszahlen auf Ihren Kern-Labels sind der schnellste Wahrheitstest.
Bei Erfolg befördern
Wenn der wiederhergestellte Graph stimmt, richten Sie Ihre App darauf aus (oder wiederholen den Restore mit „Overwrite existing" — ein expliziter Opt-in). Besser: der wöchentliche Restore-Drill erbringt den Beweis automatisch.
Stolperfallen vermeiden
- Auf der Community-Edition verlangt `neo4j-admin database dump` eine gestoppte Datenbank — ein Live-Dump wird nicht unterstützt, und /data im Betrieb zu kopieren ist inkonsistent.
- Die Enterprise-Edition bietet heiße Online-Backups via `neo4j-admin database backup`; Community braucht einen kurzen Stopp oder dumpt eine Sekundärinstanz.
- Der Bolt-Port (7687) ist für Clients; Backups laufen über neo4j-admin im Container, nicht über Bolt.
Häufige Neo4j-Backup-Probleme
- Symptom
- Der Dump-Schritt scheitert auf Community mit „database is in use".
- Ursache
- neo4j-admin database dump verlangt auf Community eine gestoppte Datenbank; ein Dump im laufenden Betrieb wird nicht unterstützt.
- Lösung
- Backup mit kurzem Stopp in eine ruhige Stunde legen, eine Sekundärinstanz dumpen — oder auf Enterprise wechseln, das heiße Online-Backups mit neo4j-admin database backup bietet.
- Symptom
- Die wiederhergestellte Datenbank startet, aber Abfragen mit APOC oder GDS scheitern.
- Ursache
- Plugins gehören zu Image und Config, nicht zum Dump — das Restore-Ziel-Image liefert sie nicht mit.
- Lösung
- In ein Image mit denselben NEO4J_PLUGINS (APOC, GDS) wiederherstellen, bevor der Dump geladen wird, und die fehlgeschlagenen Prozeduren erneut ausführen.
- Symptom
- neo4j-admin database load weigert sich, das Ziel zu überschreiben.
- Ursache
- Der load-Befehl ersetzt eine bestehende Datenbank nicht ohne ausdrückliche Anweisung, und das Ziel muss gestoppt sein.
- Lösung
- Zieldatenbank stoppen und --overwrite-destination=true übergeben (genau das tut der dokumentierte Restore-Befehl), dann Neo4j starten.
- Symptom
- Backups sind viel größer, als der Graph vermuten lässt.
- Ursache
- Der Dump enthält den vollen Store; das Rauschen der Transaktionslogs zwischen zwei Dumps mindert zudem die restic-Deduplizierung.
- Lösung
- Dumps im täglichen Zeitplan halten und Prune + Retention die Historie beschneiden lassen; den Größentrend auf der Projektkarte beobachten, um zu bestätigen, dass die Aufbewahrung greift.
Mit Dockstash in einem Klick
Dockstash führt exakt den obigen Dump aus, übergibt ihn off-site an restic und drill-testet den Restore automatisch — kein Skript zu pflegen.
Zuletzt aktualisiert: July 2026
Häufig gestellte Fragen
Kann ich Neo4j sichern, ohne es zu stoppen?
Auf Enterprise ja — `neo4j-admin database backup` liefert ein heißes Online-Backup. Auf Community verlangt `database dump` eine gestoppte Datenbank; Dockstash plant einen kurzen Stopp oder dumpt eine Replik.
Warum nicht das Verzeichnis /data/databases kopieren?
Graph-Store und Transaktionslogs werden kontinuierlich geschrieben. Eine Live-Kopie ist inkonsistent und lädt womöglich nicht. neo4j-admin dump/backup erzeugen ein konsistentes, wiederherstellbares Artefakt.
Wie stelle ich einen Neo4j-Dump wieder her?
Mit `neo4j-admin database load ... --overwrite-destination=true` gegen ein gestopptes Ziel, dann Neo4j starten. Dockstash lädt vor jedem Überschreiben zuerst in eine Staging-Datenbank.
Enthält das Backup installierte Plugins?
Nein — Plugins (APOC, GDS) gehören zu Image/Config, nicht zum Datenbank-Dump. Stellen Sie sicher, dass das Restore-Ziel-Image dieselben Plugins hat, bevor Sie laden.
Wie oft sollte ich Neo4j sichern?
Täglich ist der praktikable Standard — wählen Sie Ihre ruhigste Stunde, wenn Sie Community fahren und das kurze Stopp-Fenster brauchen. Free = nur manuelle Backups; Pro erlaubt bis stündlich, Business jeden Cron-Ausdruck.
Wo liegen die Backups eigentlich?
Auf Ihrem eigenen Storage-VPS, als verschlüsselte restic-Snapshots per SSH übertragen. Das Dump-Artefakt wird verschlüsselt, bevor es Ihren Server verlässt, und das Repository-Passwort verlässt nie Ihre Hände.
Woher weiß ich ohne manuellen Restore, dass das Backup wiederherstellbar ist?
Planen Sie einen Restore-Drill. Dockstash stellt den neuesten Snapshot in einen isolierten Arbeitsbereich wieder her, vergleicht jede Datei byteweise mit der Quelle und verifiziert den erfassten Dump — dann stempelt es ein Bestanden/Fehlgeschlagen-Badge aufs Projekt. Ein wöchentlicher Drill heißt: immer frischer Beweis.