Comment sauvegarder un conteneur Docker Neo4j (2026)
Neo4j exige un dump cohérent avant de toucher restic. Dockstash exécute `neo4j-admin database dump neo4j --to-path=/backup` dans le conteneur, capture la sortie et la stocke chiffrée hors site — il ne copie jamais /data à chaud, car neo4j-admin dump (ou la sauvegarde en ligne de l'édition Enterprise) produit un instantané cohérent du store, car le store du graphe et les journaux de transactions sont écrits en continu.
Ce que Dockstash détecte
| Clés d'environnement détectées | NEO4J_AUTH, NEO4J_dbms_default__database, NEO4J_PLUGINS |
|---|---|
| Port par défaut | 7687 |
| Chemins de données vivants (jamais copiés à chaud) | /data, /data/databases, /data/transactions |
| Exemples d'images | neo4j:5, neo4j:5-community, neo4j:5-enterprise, neo4j |
Sauvegarder Neo4j avec Dockstash, étape par étape
Créez votre compte Dockstash et ouvrez le tableau de bord
Inscrivez-vous gratuitement sur app.dockstash.com/register. L'assistant de configuration unique vous demande votre VPS de stockage (la machine qui hébergera les sauvegardes chiffrées) et génère un mot de passe de chiffrement — enregistrez-le immédiatement dans un gestionnaire de mots de passe, il n'est affiché qu'une seule fois.
Ajoutez le projet Docker qui exécute Neo4j
Sur l'écran Projects, Dockstash détecte automatiquement chaque dossier de projet Compose du serveur (par défaut sous /var/www). Choisissez le projet qui contient votre service Neo4j. Rien n'est encore sauvegardé — vous indiquez simplement à Dockstash où vit le projet.
Vérifiez que Neo4j a bien été détecté
Ouvrez le projet et regardez l'onglet Plan. Dockstash lit docker-compose.yml, reconnaît l'image neo4j et enregistre le conteneur résolu ainsi que les clés d'environnement trouvées (NEO4J_AUTH, NEO4J_PLUGINS). Vous pouvez activer ou désactiver fichiers, bases et configs de proxy avant d'enregistrer.
Comprenez comment fonctionne le dump Neo4j
Neo4j est le seul moteur où l'édition compte. Enterprise permet des sauvegardes en ligne à chaud avec neo4j-admin database backup pendant que la base continue de servir. Community exige la base arrêtée pour neo4j-admin database dump — le schéma sûr est donc un bref arrêt planifié à une heure creuse, ou le dump d'une instance secondaire. Dockstash capture l'artefact de dump résultant, jamais le répertoire /data vivant.
Confirmez votre destination de stockage
Les sauvegardes sont stockées sous forme d'instantanés restic chiffrés sur votre propre VPS de stockage, via SSH. Si vous avez terminé l'assistant de configuration, c'est déjà en place ; vous pouvez changer l'hôte, l'utilisateur, le port ou la clé SSH à tout moment dans Settings → Storage.
Définissez une planification de sauvegarde
Dans l'onglet Schedule du projet, choisissez quotidien, hebdomadaire ou une expression cron personnalisée (validée en direct). Pour Neo4j en édition Community, planifiez la sauvegarde à votre heure la plus calme pour rendre indolore la brève fenêtre de dump. Ajoutez une planification de prune hebdomadaire avec votre politique de rétention.
Lancez la première sauvegarde maintenant
Cliquez sur Backup Now sur la carte du projet. Dockstash capture le dump du graphe et les fichiers du projet et envoie le tout dans restic — vous pouvez suivre la sortie restic en direct, ligne par ligne, dans le panneau de logs.
Confirmez que l'instantané existe
À la fin de l'exécution, la carte du projet affiche la nouvelle date de dernière sauvegarde, le nombre d'instantanés et la taille du dépôt. Ouvrez l'écran Snapshots : le point de restauration apparaît dans la chronologie — c'est votre preuve que la sauvegarde est bien arrivée hors site.
La commande de dump
neo4j-admin database dump neo4j --to-path=/backupLa commande de restauration
neo4j-admin database load neo4j --from-path=/backup --overwrite-destination=trueneo4j-admin dump (ou la sauvegarde en ligne de l'édition Enterprise) produit un instantané cohérent du store, car le store du graphe et les journaux de transactions sont écrits en continu.
Restaurer une sauvegarde Neo4j et prouver qu'elle fonctionne
Une sauvegarde Neo4j ne devient réelle qu'une fois rechargée dans un graphe interrogeable. Les restaurations Dockstash n'écrasent jamais votre base vivante par défaut — vous restaurez d'abord vers un emplacement neuf, chargez dans une instance de test, puis promouvez délibérément.
Choisissez un point de restauration
Ouvrez Snapshots, sélectionnez le projet et parcourez la chronologie des points de restauration. Chaque ligne contient un artefact de dump neo4j-admin cohérent plus les fichiers du projet capturés lors de la même exécution.
Restaurez vers un nouvel emplacement
Cliquez sur Restore et gardez le mode par défaut « Restore to new location ». Tapez le nom du projet pour confirmer — une action délibérée à confirmation saisie. L'artefact de dump et les fichiers atterrissent dans le chemin cible de votre choix, sans toucher au projet vivant.
Chargez et vérifiez le graphe restauré
Démarrez un conteneur Neo4j de test (même image et mêmes plugins que la production), chargez le dump avec neo4j-admin database load sur la cible arrêtée, démarrez, puis sondez avec quelques requêtes Cypher — les comptages de nœuds et de relations sur vos labels principaux sont le test de vérité le plus rapide.
Promouvez une fois satisfait
Quand le graphe restauré est validé, pointez votre application dessus (ou répétez la restauration en mode « Overwrite existing » — un opt-in explicite). Mieux : laissez l'exercice de restauration hebdomadaire produire cette preuve automatiquement.
Pièges à éviter
- En édition Community, `neo4j-admin database dump` exige la base arrêtée — dumper un store vivant n'est pas supporté et copier /data à chaud est incohérent.
- L'édition Enterprise permet des sauvegardes en ligne à chaud via `neo4j-admin database backup` ; Community doit planifier un bref arrêt ou dumper une secondaire.
- Le port Bolt (7687) sert aux clients ; les sauvegardes passent par neo4j-admin dans le conteneur, pas par Bolt.
Problèmes courants de sauvegarde Neo4j
- Symptôme
- L'étape de dump échoue avec « database is in use » en édition Community.
- Cause
- neo4j-admin database dump exige la base arrêtée sur Community ; le dump à chaud n'est pas supporté.
- Correctif
- Planifiez la sauvegarde à une heure creuse avec un bref arrêt, dumpez une instance secondaire, ou passez à Enterprise pour des sauvegardes en ligne à chaud avec neo4j-admin database backup.
- Symptôme
- La base restaurée démarre mais les requêtes utilisant APOC ou GDS échouent.
- Cause
- Les plugins font partie de l'image et de la config, pas du dump — l'image cible de restauration ne les embarque pas.
- Correctif
- Restaurez dans une image avec les mêmes NEO4J_PLUGINS (APOC, GDS) installés avant de charger le dump, puis relancez les procédures en échec.
- Symptôme
- neo4j-admin database load refuse d'écraser la cible.
- Cause
- La commande load ne remplace pas une base existante sans y être explicitement invitée, et la cible doit être arrêtée.
- Correctif
- Arrêtez la base cible et passez --overwrite-destination=true (exactement ce que fait la commande de restauration documentée), puis démarrez Neo4j.
- Symptôme
- Les sauvegardes sont bien plus volumineuses que la taille apparente du graphe.
- Cause
- Le dump inclut le store complet ; l'agitation des journaux de transactions entre deux dumps réduit aussi la déduplication restic.
- Correctif
- Gardez les dumps sur une planification quotidienne et comptez sur prune + rétention pour élaguer l'historique ; surveillez la tendance de taille du dépôt sur la carte du projet pour confirmer que la rétention agit.
Faites-le en un clic avec Dockstash
Dockstash exécute exactement le dump ci-dessus, le confie à restic hors site et teste la restauration par un drill automatiquement — aucun script à maintenir.
Dernière mise à jour : July 2026
Questions fréquentes
Puis-je sauvegarder Neo4j sans l’arrêter ?
Sur Enterprise, oui — utilisez `neo4j-admin database backup` pour une sauvegarde en ligne à chaud. Sur Community, la commande `database dump` exige la base arrêtée : Dockstash planifie un bref arrêt ou dumpe une réplique.
Pourquoi ne pas copier le répertoire /data/databases ?
Le store du graphe et les journaux de transactions sont écrits en continu. Une copie à chaud est incohérente et peut ne pas se charger. neo4j-admin dump/backup produisent un artefact cohérent et restaurable.
Comment restaurer un dump Neo4j ?
Utilisez `neo4j-admin database load ... --overwrite-destination=true` sur une cible arrêtée, puis démarrez Neo4j. Dockstash charge d'abord dans une base de staging avant tout écrasement.
La sauvegarde inclut-elle les plugins installés ?
Non — les plugins (APOC, GDS) font partie de l'image/config, pas du dump de la base. Vérifiez que l'image cible de restauration a les mêmes plugins avant de charger.
À quelle fréquence sauvegarder Neo4j ?
Quotidien est le défaut pratique — choisissez votre heure la plus calme si vous êtes en Community et avez besoin de la brève fenêtre d'arrêt. Free = sauvegardes manuelles uniquement ; Pro autorise jusqu'à l'horaire, Business n'importe quelle expression cron.
Où vivent réellement les sauvegardes ?
Sur votre propre VPS de stockage, sous forme d'instantanés restic chiffrés poussés via SSH. L'artefact de dump est chiffré avant de quitter votre serveur, et le mot de passe du dépôt ne quitte jamais vos mains.
Comment savoir que la sauvegarde est restaurable sans restauration manuelle ?
Planifiez un exercice de restauration. Dockstash restaure le dernier instantané dans un espace de travail isolé, compare chaque fichier par empreinte d'octets avec la source et vérifie le dump capturé — puis appose un badge réussite/échec sur le projet. Un exercice hebdomadaire vous garantit une preuve toujours fraîche.