Dolibarr : sauvegarder base et documents

Une sauvegarde Dolibarr couvre la base de données et le répertoire documents.

Prérequis

• Profil administrateur pour la sauvegarde par interface.
• Accès shell pour la sauvegarde CLI.
• mysqldump disponible.

1. Sauvegarde via l’interface

Menu Configuration → Sauvegarde.

• Sauvegarder la base de données : choisir mysqldump, format Compressé (gz).
• Cliquer Générer la commande puis Lancer l'export.
• Télécharger l’archive proposée.

2. Sauvegarde de la base en CLI

Les paramètres se trouvent dans htdocs/conf/conf.php. Lancer :

mysqldump --single-transaction --quick \
  -h db.exemple.fr -u dolibarr -p \
  dolibarrdb | gzip > /sauvegardes/dolibarr-$(date +%F).sql.gz

3. Sauvegarde des documents

Le répertoire $dolibarr_main_data_root (souvent /var/lib/dolibarr/documents) contient PDF, justificatifs et pièces jointes :

tar czf /sauvegardes/dolibarr-docs-$(date +%F).tar.gz \
  /var/lib/dolibarr/documents

4. Sauvegarde de la configuration

cp /var/www/dolibarr/htdocs/conf/conf.php \
   /sauvegardes/conf-$(date +%F).php

5. Automatiser

Ajouter une tâche cron quotidienne :

0 2 * * * mysqldump --single-transaction -u dolibarr -pMOTDEPASSE dolibarrdb | gzip > /sauvegardes/dolibarr-$(date +\%F).sql.gz

Vérification

gzip -t /sauvegardes/dolibarr-2024-12-05.sql.gz && echo "dump valide"
tar tzf /sauvegardes/dolibarr-docs-2024-12-05.tar.gz | head

Dépannage

• Export interface vide : mysqldump introuvable ; renseigner son chemin dans Configuration → Sauvegarde.
• « Access denied » : identifiants incorrects dans conf.php.
• Archive documents incomplète : variable dolibarr_main_data_root pointant ailleurs ; la relire dans conf.php.
• Restauration : recréer la base, importer le dump (zcat dump.sql.gz | mysql ...), restaurer documents/ et conf.php.