Dans ce tutoriel dédié à la configuration de Home Assistant, je vais vous expliquer comment configurer Home Assistant pour utiliser MariaDB comme serveur de base de données pour l’enregistrement des données.
Par défaut Home Assistant est configuré pour utiliser SQLite, qui n’est pas un serveur de base de données, SQLite permet au application d’avoir une base de données qui est directement stocké dans un fichier.
Si vous prévoyez d’intègre de nombres équipements, il est préférable sur le long terme de se tourner vers MariaDB qui aura de meilleur performance que SQLite.
Avertissement
Il n’existe pas d’outil officiel de migration SQLite vers MariaDB, si vous faites cette migration alors que vous avez déjà des équipements, vous perdrez l’historique des données comme la consommation des prises connectées.
Installation du module complémentaire MariaDB
On va commencer par installer le module complémentaire MariaDB sur notre serveur Home Assistant.
Depuis la panneau de gauche, cliquer sur Paramètres 1.
Sur la page des Paramètres, cliquer sur Modules complémentaires 1.
Pour afficher les add-ons disponible à l’installation, cliquer sur le bouton BOUTIQUES DES MODULES COMPLEMENTAIRES 1.
On va retrouver l’add-on pour MariaDB dans les Add-ons officiel, cliquer sur le module complémentaire MariaDB 1.
Cliquer sur INSTALLER 1.
Patienter pendant l’installation …
L’add-on MariaDB est installé, on ne va pas le démarrer tout de suite, il faut d’abord le configurer, cliquer sur Configuration 1 qui se trouve en haut.
Ici, vous accès à la configuration du serveur MariaDB.
La seule chose à faire ici, c’est de configurer le mot de passe pour l’utilisateur homeassistant. Changer le mot de passe de null par un autre mot de passe 1 puis cliquer sur ENREGISTER 2.
Je vous conseille de générer un mot de passe aléatoire.
Retourner sur la page principal du module en cliquant sur Info 1 puis cliquer sur DEMARRER 2.
Le conteneur qui fait fonctionner le serveur MariaDB est démarré.
On peut vérifier dans les logs (Journal) qu’il n’y a pas d’erreurs.
Le serveur MariaDB pour Home Assistant est prêt.
Configurer Home Assistant pour utiliser MariaDB
Maintenant, il faut configurer Home Assistant pour lui indiquer d’utiliser le serveur MariaDB à la place de SQLite, il faut pour cela éditer le fichier de configuration : configuration.yaml en indiquant que les recorders sont stocké sur MariaDB.
Dans la panneau de gauche, ouvrir File editor 1.
Cliquer sur le dossier 1 pour accéder aux fichiers.
Cliquer sur le fichier secrets.yaml 1.
Dans ce fichier, on va ajouter la chaine de connexion au serveur MariaDB qui va contenir le mot de passe.
Voici la chaine à ajouter en remplaçant <PASSWORD> par le mot de passe configurer.
mariadb_url: 'mysql://homeassistant:<PASSWORD>@core-mariadb/homeassistant?charset=utf8mb4'Une fois ajoutée, enregistrer la modification en cliquant sur la disquette 1.
Ouvrir le fichier configuration.yaml 1 de la même façon.
Dans le fichier configuration.yaml on va indiquer à Home Assistant d’utiliser MariaDB pour stockage des enregistrements de métriques (recorder).
Pour cela ajouter la ligne suivante :
recorder:
db_url: !secret mariadb_url
Sauvegarder 1 les modifications.
On va maintenant redémarrer Home Assistant pour la prise en compte des modifications de configuration. Aller sur les Outils de développements 1 puis cliquer sur VERIFIER LA CONFIGURATION 2.
S’il n’y a pas d’erreur, cliquer sur REDEMARRER 1.
Cliquer sur Redémarrer Home Assistant 1.
Confirmer le redémarrage en cliquant de nouveau sur REDEMARRER 1.
Patienter pendant le redémarrage de Home Assistant.
Une fois redémarrer, on va vérifier les logs pour s’assurer qu’il n’y a pas d’erreur liée à la base de données.
Dans les Paramètres 1, cliquer sur Système 2.
Cliquer ensuite sur Journaux 1.
Dans les logs, vérifier qu’il n’y a pas d’erreur liée à la base de données.
Vous savez maintenant comment configurer Home Assistant pour utiliser une base de données MariaDB.