Guide de démarrage rapide - Borgmatic

Installation et configuration en 5 minutes.

Installation rapide

# 1. Cloner le dépôt (si pas déjà fait)
git clone <url-du-repo>
cd agence66-borgmatic

# 2. Configurer les variables d'environnement
cp .env.example .env
nano .env  # Éditer avec vos valeurs (voir ci-dessous)

# 3. Installer
sudo ./install.sh

Configuration .env

Éditez .env avec vos valeurs :

# Repository Borg
BORG_REPO=/chemin/vers/votre/repo
# ou pour un repo distant:
# BORG_REPO=ssh://user@backup-server.com/path/to/repo

# Passphrase de chiffrement
BORG_PASSPHRASE=votre-passphrase-securisee

# Notifications ntfy
NTFY_URL=https://ntfy.sh/votre-topic
NTFY_USER=username:password

Initialiser le repository (si nouveau)

# Repository local
borg init --encryption=repokey-blake2 /path/to/repo

# Repository distant
borg init --encryption=repokey-blake2 ssh://user@server/path/to/repo

# IMPORTANT: Sauvegarder la clé !
borg key export /path/to/repo backup-key.txt

Tests

# 1. Tester les notifications
./scripts/test-notifications.sh

# 2. Vérifier la santé du système
sudo ./scripts/healthcheck.sh

# 3. Test à vide (dry-run)
sudo borgmatic --dry-run --verbosity 2

# 4. Premier backup réel
sudo borgmatic --verbosity 1

Vérifier le timer

# Vérifier que le timer est actif
systemctl status borgmatic.timer

# Voir quand le prochain backup aura lieu
systemctl list-timers | grep borgmatic

Commandes utiles

# Lister les backups
borgmatic list

# Voir les logs
journalctl -u borgmatic.service -f

# Exécuter un backup manuel
sudo borgmatic

# Restaurer des fichiers
./scripts/restore.sh

# Vérifier l'intégrité
sudo borgmatic check

Compatibilité avec ancien script

Si vous migriez depuis l'ancien script Borg :

Votre repository existant est compatible
Les archives existantes restent accessibles
Le format de nommage est identique
Aucune migration n'est nécessaire

Pour vérifier :

# Lister les anciennes archives
borg list $BORG_REPO

# Tester avec borgmatic
borgmatic list

Migration depuis ancien repository

Si vous avez un repository Borg existant, il suffit de :

# 1. Pointer BORG_REPO vers votre repository existant dans .env
BORG_REPO=/path/to/existing/repo

# 2. Utiliser la même passphrase
BORG_PASSPHRASE=votre-ancienne-passphrase

# 3. Tester
borgmatic list  # Devrait afficher vos anciennes archives

En cas de problème

# Vérifier la santé
sudo ./scripts/healthcheck.sh

# Voir les logs
journalctl -u borgmatic.service -n 50

# Tester la configuration
borgmatic config validate

# Mode verbeux
sudo borgmatic --verbosity 2

Support

Consultez le README.md pour plus de détails.

2.8 KiB Raw Blame History