Aller au contenu

Backups Home Assistant

Stratégie de sauvegarde de Home Assistant et récupération en cas de panne.

Vue d'ensemble

Type Fréquence Rétention Destination
Snapshot Proxmox Hebdomadaire 4 semaines PBS
Configuration Git À chaque modification Illimitée Gitea local

ℹ️ Pas d'add-on de backup HA installé. La sauvegarde repose sur les snapshots Proxmox et le versionnement Git.

Architecture backup

flowchart LR
    subgraph proxmox["Proxmox"]
        VM100[VM 100<br/>Home Assistant]
    end

    VM100 --> PBS[Proxmox Backup Server<br/>192.168.1.165]
    VM100 --> Gitea[Gitea<br/>Configuration YAML]

Backup Home Assistant natif

Backup manuel (avant mise à jour)

Pour créer un backup ponctuel avant une mise à jour importante :

  1. Paramètres → Système → Sauvegardes
  2. Créer une sauvegarde
  3. Choisir : Complète ou Partielle
  4. Nommer le backup (ex: pre-update-2024-03)

⚠️ Ces backups sont stockés localement dans /backup de la VM. En cas de perte de la VM, ils sont perdus aussi. Privilégier les snapshots Proxmox.

Backup Proxmox (VM 100)

Proxmox Backup Server

Home Assistant (VM 100) est sauvegardé sur PBS (192.168.1.165).

Paramètre Valeur
Datastore local-pbs
Schedule Hebdomadaire (dimanche 02:00)
Rétention 4 derniers backups
Mode Snapshot

Commandes PBS

# Lister les backups de la VM 100
ssh root@192.168.1.32 "pvesh get /nodes/proxmox/qemu/100/snapshots"

# Créer un backup manuel
ssh root@192.168.1.32 "vzdump 100 --storage pbs-local --mode snapshot"

# Restaurer depuis PBS (via interface web recommandé)

Accès interface PBS

  • URL : https://192.168.1.165:8007
  • User : root@pam

Sauvegarde configuration Git

Repository Gitea

La configuration YAML est versionnée dans Gitea (LXC 121, proxmox2).

Repository Contenu
homeassistant-config Configuration YAML
domotique Documentation + scripts

Fichiers versionnés

/config/
├── configuration.yaml
├── automations.yaml
├── scripts.yaml
├── scenes.yaml
├── secrets.yaml.example  # Template sans secrets
├── customize.yaml
└── packages/
    ├── alarmo.yaml
    ├── evcc.yaml
    └── ...

⚠️ Important : secrets.yaml contient les mots de passe et ne doit JAMAIS être commité. Utiliser .gitignore.

Workflow Git

# Depuis le terminal Home Assistant
cd /config
git add .
git commit -m "Ajout automation éclairage"
git push origin main

Restauration

Restaurer backup HA natif

  1. Installation fraîche de Home Assistant
  2. Accéder à l'onboarding : http://homeassistant.local:8123
  3. Choisir "Restaurer depuis une sauvegarde"
  4. Uploader le fichier .tar ou connecter Google Drive

Restaurer depuis PBS

  1. Accéder à Proxmox : https://192.168.1.32:8006
  2. Datacenter → Storage → pbs-local
  3. Sélectionner le backup de VM 100
  4. Restore → Choisir la destination

Restaurer configuration Git

# Cloner le repo sur une nouvelle installation
cd /config
git clone http://192.168.1.70:3000/admin/homeassistant-config.git .

# Restaurer secrets.yaml manuellement
cp /backup/secrets.yaml /config/

Bonnes pratiques

Avant une mise à jour

  1. Créer un backup complet nommé pre-update-YYYY-MM-DD
  2. Créer un snapshot Proxmox de la VM 100
  3. Noter la version actuelle

Vérification des backups

Vérification Fréquence
Taille du dernier backup Hebdomadaire
Restauration test (VM isolée) Trimestrielle
Intégrité PBS Mensuelle

Exclusions recommandées

Pour réduire la taille des backups :

# Dans le backup HA, exclure :
- home-assistant_v2.db  # Peut être recréé
- home-assistant.log
- .storage/lovelace_dashboards  # Si versionné ailleurs

Monitoring backups

Vérification snapshots PBS

Les snapshots Proxmox sont visibles dans l'interface PBS : - URL : https://192.168.1.165:8007 - Datastore : Vérifier la présence de backups récents de VM 100

Récupération d'urgence

Procédure rapide

  1. Si VM 100 inaccessible :
  2. Accéder à Proxmox : https://192.168.1.32:8006
  3. Console VM 100 → Vérifier l'état

  4. Redémarrer si nécessaire

  5. Si VM corrompue :

  6. Restaurer depuis PBS (dernier backup)

  7. Ou réinstaller + restaurer backup HA

  8. Si Proxmox HS :

  9. Installer HA sur autre machine
  10. Restaurer depuis backup externe

Contacts urgence

Voir Urgences - Panne domotique

Voir aussi