149 lines
2.8 KiB
Markdown
149 lines
2.8 KiB
Markdown
# Guide de démarrage rapide - Borgmatic
|
|
|
|
Installation et configuration en 5 minutes.
|
|
|
|
## Installation rapide
|
|
|
|
```bash
|
|
# 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 :
|
|
|
|
```bash
|
|
# 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)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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 :
|
|
|
|
1. Votre repository existant **est compatible**
|
|
2. Les archives existantes **restent accessibles**
|
|
3. Le format de nommage **est identique**
|
|
4. Aucune migration n'est nécessaire
|
|
|
|
Pour vérifier :
|
|
|
|
```bash
|
|
# 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 :
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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](README.md) pour plus de détails.
|