Document : Sauvegarder Home Assistant sur Nextcloud via WebDAV

Sauvegarder Home Assistant sur Nextcloud via WebDAV

  • admin
  • Home Assistant, Nextcloud, Raspberry Pi

Ce guide détaille la configuration pas à pas de l'intégration WebDAV native de Home Assistant pour transférer automatiquement vos sauvegardes chiffrées vers votre instance Nextcloud.

Stratégie et prérequis

La perte d'une passerelle domotique peut paralyser l'ensemble des automatismes d'un logement. Conserver une copie de vos sauvegardes sur un serveur distant garantit la restauration rapide de votre environnement en cas de défaillance matérielle du support local.

Avant d'entamer la configuration, assurez-vous de disposer des éléments suivants :

  • Une instance Home Assistant opérationnelle.
  • Une instance Nextcloud fonctionnelle, accessible en HTTPS avec un certificat TLS valide.
  • Un compte utilisateur Nextcloud pour héberger les fichiers de sauvegarde.

Préparation côté Nextcloud

Pour sécuriser les échanges sans exposer les identifiants principaux de votre compte, la communication repose sur un mot de passe d'application dédié. La préparation consiste à générer ce secret, à créer un répertoire cible et à relever l'adresse du point de terminaison WebDAV.

Création d'un mot de passe d'application

  1. Connectez-vous à l'interface de votre instance Nextcloud.
  2. Cliquez sur votre avatar en haut à droite, puis sélectionnez Paramètres personnels.
  3. Dans le menu latéral gauche, cliquez sur la rubrique Sécurité.
  4. Au bas de la page, localisez la section relative aux appareils et sessions. Saisissez un nom explicite dans le champ dédié (par exemple Home Assistant Backups), puis cliquez sur le bouton Créer un nouveau mot de passe d'application.
  5. Renseignez le mot de passe de votre compte Nextcloud pour confirmer l'opération.
  6. Une fenêtre affiche alors les identifiants générés. Copiez immédiatement le mot de passe et conservez-le dans votre gestionnaire de secrets. Cette information ne sera plus visible après la fermeture de la fenêtre.

Création du répertoire de stockage

  1. Rendez-vous dans l'application Fichiers depuis la barre de navigation supérieure de Nextcloud.
  2. Créez un nouveau dossier et saisissez un nom (par exemple ha_backups), puis validez.

Masquer le dossier dans Nextcloud

Vous pouvez préfixer le nom du dossier par un point (par exemple .ha_backups). Cette convention masque le répertoire dans l'interface web classique de Nextcloud et évite d'encombrer votre vue quotidienne de fichiers.

Récupération de l'adresse WebDAV

L'URL de base du protocole WebDAV est accessible depuis l'interface Fichiers :

  1. Cliquer ensuite sur le menu Paramètres des fichiers situé tout en bas du panneau latéral gauche.
  2. Copiez l'adresse affichée dans le champ WebDAV.

L'URL standard fournie par Nextcloud adopte la structure suivante :

https://cloud.votredomaine.tld/remote.php/dav/files/utilisateur

Configuration de l'intégration WebDAV dans Home Assistant

Home Assistant intègre un support natif du protocole WebDAV comme emplacement de stockage distant pour son gestionnaire de sauvegardes.

La configuration requiert de découper l'adresse WebDAV fournie par Nextcloud en deux segments distincts. Le champ d'URL de l'intégration attend la racine du service WebDAV se terminant par /dav/. Le chemin d'accès relatif au compte et au dossier cible doit quant à lui être renseigné séparément dans le champ dédié.

Ajout de l'intégration

  1. Dans Home Assistant, accédez à Paramètres > Appareils et services.
  2. Cliquez sur le bouton Ajouter une intégration en bas à droite.
  3. Recherchez WebDAV et sélectionnez l'entrée correspondante.
  4. Renseignez les paramètres de connexion :
    • URL : la racine du service WebDAV (par exemple : https://cloud.votredomaine.tld/remote.php/dav/).
    • Nom d'utilisateur : votre identifiant Nextcloud.
    • Mot de passe : le mot de passe d'application généré précédemment.
    • Chemin des sauvegardes : le chemin relatif vers le dossier cible, en commençant par le segment files (par exemple : /files/utilisateur/ha_backups ou /files/utilisateur/.ha_backups).
    • Vérifier le certificat SSL : cochez impérativement cette option.
  5. Validez le formulaire pour enregistrer l'intégration.

Modification des paramètres

L'intégration WebDAV ne propose pas de menu de reconfiguration. En cas d'erreur de saisie, supprimez l'intégration puis recommencez l'ajout.

Définition de l'emplacement distant

  1. Rendez-vous dans Paramètres > Système > Sauvegardes.
  2. Dans la section Sauvegarde automatique, cliquez sur le bouton Configurer les sauvegardes.
  3. Dans la section relative aux emplacements, cochez le stockage WebDAV.

Chiffrement des sauvegardes

Activez systématiquement le chiffrement de vos sauvegardes. Vos archives contiennent des clés d'API, des mots de passe et l'historique complet de votre logement. Vous trouverez la clé de chiffrement dans Paramètres > Système > Sauvegardes, section Clé de chiffrement. Conservez précieusement cette clé dans votre gestionnaire de mots de passe.

Validation et test de transfert

Une fois le stockage rattaché, il convient de déclencher une sauvegarde manuelle pour valider le bon fonctionnement du transfert vers Nextcloud :

  1. Dans Paramètres > Système > Sauvegardes, cliquez sur le bouton + Sauvegarder maintenant situé en bas à droite.
  2. Sélectionnez l'option Sauvegarde automatique.
  3. Une fois le processus de sauvegarde terminé, ouvrez l'interface de votre instance Nextcloud et parcourez le répertoire cible (ha_backups).
  4. Vérifiez la présence de l'archive au format .tar ainsi que la cohérence de sa taille.