Comment installer Home Assistant sur Saplo : intégrations et première automatisation

Tu utilises des appareils de différents fabricants et souhaites centraliser leur gestion et leurs automatisations. Home Assistant te permet de connecter des services compatibles au sein d'un panneau commun. Dans ce tutoriel, nous allons te montrer comment installer Home Assistant sur Saplo, effectuer la première configuration et vérifier une automatisation simple sans connecter de matériel.

Quand Home Assistant sur Saplo a du sens

L'installation sur Saplo sera utile pour les intégrations utilisant Internet et comme environnement pour apprendre l'automatisation. Le Panneau fonctionne sur un serveur dans un centre de données et est accessible via HTTPS. Cependant, la compatibilité d'un appareil spécifique dépend de son intégration, de sa méthode de communication et des exigences du fabricant.

La Box n'a pas automatiquement accès à ton réseau domestique. Taper l'adresse privée de l'appareil, par exemple 192.168.1.20, ne fournira pas de connexion depuis le serveur Saplo. Les appareils locaux nécessitent une connectivité configurée séparément, par exemple un tunnel VPN avec des routes et des règles d'accès appropriées. L'installation de Home Assistant elle-même ne crée pas un tel tunnel. La détection automatique via mDNS ou SSDP ne commencera pas non plus à fonctionner simplement parce que tu connectes des réseaux VPN.

La recette ne fournit pas d'accès USB, tu ne pourras donc pas y connecter directement un coordinateur Zigbee ou Z-Wave domestique. Si la base de ton système est constituée de capteurs locaux et de commandes fonctionnant sans Internet, envisage de laisser le centre d'automatisation à la maison. Avec une installation à distance, la perte de l'Internet domestique coupe la communication avec les appareils, même si le Panneau Saplo lui-même continue de fonctionner.

Exigences et hébergement de Home Assistant sur Saplo

Le plan le moins cher qui réponde aux exigences minimales de la recette est le Box M à 63 € par an. La recette nécessite 2048 MB de RAM et 10 GB d'espace disque. Si d'autres applications sont déjà actives sur le Box, vérifie les ressources disponibles avant l'installation. L'historique croissant des mesures et les intégrations supplémentaires augmentent les besoins en mémoire et en espace disque.

Prépare un Box actif, le nom de l'application et l'adresse à laquelle elle sera disponible. Tu n'as pas besoin de créer une base de données séparée ni d'installer Docker manuellement. Tu trouveras les détails du service sur la page Home Assistant de Saplo.

Saplo lance Home Assistant dans l'image de conteneur officielle. C'est une installation de type Home Assistant Container, sans Supervisor ni magasin d'add-ons comme ceux de Home Assistant OS. Les intégrations ajoutées dans les paramètres de Home Assistant sont une fonction différente des applications gérées par Supervisor. Les différences sont décrites dans la documentation officielle d'installation de Container.

Installation étape par étape

1. Connecte-toi à ton Panneau Saplo et ouvre le Catalogue d'applications.
2. Recherche Home Assistant et commence l'ajout de l'application.
3. Donne-lui un nom, par exemple my-smart-home, et choisis une Box avec les ressources appropriées.
4. Sélectionne une adresse d'application disponible. Tu peux commencer avec un sous-domaine *.saploapp.pl.
5. Valide l'installation et attends qu'elle soit terminée dans le Panneau. Le temps dépendra notamment du téléchargement de l'image et de la charge du serveur.
6. Ouvre l'adresse HTTPS exacte indiquée avec l'application. Saplo prépare le Domaine et le certificat SSL au démarrage.
7. Passe directement l'assistant de première exécution et crée le Compte du propriétaire.

Utilise le Domaine visible dans le Panneau, sans ajouter le port 8123. L'adresse homeassistant.local, rencontrée dans les guides d'installation domestique, n'est pas l'adresse de ton application sur Saplo.

Première connexion et réglages de ta maison

Dans l'assistant d'installation, saisis un nom d'utilisateur et un mot de passe fort et unique. Tu créeras toi-même le compte propriétaire de Home Assistant, il est indépendant de ton compte dans le Panneau Saplo. Enregistre les données dans un gestionnaire de mots de passe et ne laisse pas l'assistant inachevé à une adresse publique.

Règle l'emplacement de ta maison, vérifie le fuseau horaire Europe/Warsaw et les unités. Indique l'emplacement des appareils que tu veux contrôler, et non celui du centre de données. C'est important pour les heures de lever et de coucher du soleil. Choisis les paramètres de partage de données et termine la configuration. Le déroulement de l'assistant est décrit dans la Documentation du premier démarrage.

Ta première intégration sans matériel supplémentaire

Pour commencer, ajoute Workday, l'intégration des jours ouvrables. Elle te permettra de tester le fonctionnement des intégrations sans compte fournisseur et sans connexion à ton réseau domestique.

1. Ouvre Paramètres > Appareils et services.
2. Sélectionne l'ajout d'intégration et recherche Workday.
3. Définis la France comme pays et attribue un nom, par exemple « Jour ouvrable ».
4. Vérifie les jours de la semaine sélectionnés et les paramètres de vacances. Laisse le décalage de jours à zéro si tu souhaites vérifier le jour actuel.
5. Termine la configuration, ouvre l'intégration ajoutée et vérifie l'état de son entité.

Une entité représente une lecture ou une fonction spécifique, ici l'information sur le jour ouvrable. Tu trouveras les instructions pour ajouter Workday dans le guide d'intégration officiel. Ajoute les intégrations suivantes une par une et consulte leur documentation avant de fournir tes informations de connexion.

Premiers pas avec l'automatisation et vérification

Prépare un test qui affichera une notification dans Home Assistant à une heure choisie. Cela ne nécessite ni téléphone, ni lampe, ni capteur.

1. Ouvre Paramètres > Automatisations et scènes, ajoute une automatisation et choisis de créer une règle vierge.
2. Ajoute un déclencheur temporel, en réglant l'heure quelques minutes après l'heure actuelle de ton fuseau horaire configuré.
3. Pour ce test, laisse la section des conditions vide.
4. Ajoute l'action persistent_notification.create. Définis le titre sur "Test Saplo" et le contenu sur "L'automatisation fonctionne".
5. Enregistre la règle sous le nom "Test de notification" et assure-toi qu'elle est activée.
6. Attends l'heure choisie. Vérifie la notification dans l'interface Home Assistant et le journal d'exécution de l'automatisation.
7. Après un test réussi, désactive ou supprime la règle de test pour qu'elle ne se déclenche pas tous les jours.

L'éditeur est décrit dans la documentation sur l'automatisation, et les champs d'action se trouvent dans la documentation sur les notifications persistantes. Il s'agit d'une notification à l'intérieur du Panneau, et non d'un message push sur ton téléphone.

Le déclenchement manuel de l'action aide à vérifier sa configuration, mais ne confirme pas le fonctionnement du déclencheur temporel. Attends donc également l'exécution planifiée. Ensuite, déconnecte-toi, reconnecte-toi et vérifie si l'intégration et la règle enregistrée sont toujours visibles.

Que vérifier si quelque chose ne fonctionne pas

La page ne s'ouvre pas après l'installation. Vérifie le statut de l'application dans le Panneau Saplo et l'adresse HTTPS complète. Si tu vois une erreur, transmets au Support Saplo le nom de l'application, l'heure de la tentative et le message. Ne supprime pas une installation contenant déjà une configuration juste pour réessayer.

Home Assistant ne trouve pas les appareils de la maison. Avec cette recette, c'est attendu. Vérifie si l'intégration choisie utilise le cloud du fabricant ou nécessite une connexion directe avec l'appareil. Pour une connexion locale, tu as besoin d'un chemin réseau disponible et d'une intégration supportant ce mode de fonctionnement. N'expose pas le panneau de l'appareil sur Internet pour contourner le problème.

L'automatisation ne se déclenche pas à l'heure. Vérifie le fuseau horaire, l'activation de la règle et l'heure définie. Ouvre la trace d'exécution pour voir si la règle a été déclenchée et à quelle étape elle s'est arrêtée.

Il n'y a pas de magasin d'addons. C'est une caractéristique de l'installation Container. Les tutoriels nécessitant Supervisor et les addons Home Assistant OS ne s'appliquent pas directement à cette installation.

Sauvegardes et extensions futures

La Box M n'inclut pas de sauvegarde dans le prix du plan. Assure-toi de sauvegarder les données et la configuration de Home Assistant en dehors de la Box, surtout avant une mise à jour ou un changement majeur. La simple sauvegarde des automatisations ou du répertoire de configuration permanent ne remplace pas une sauvegarde. Vérifie également la possibilité de restaurer une sauvegarde avant de confier la gestion quotidienne de ta maison à l'installation.

Après une première tentative réussie, ajoute une intégration à la fois et observe l'utilisation des ressources. Le lancement du Panneau ne signifie pas encore que tous les appareils sont accessibles. Vérifie chaque connexion et chaque automatisation séparément.

Si Home Assistant doit accéder aux appareils de ta maison sans les exposer à Internet, un réseau VPN privé sera utile. Nous avons décrit comment installer Headscale, ton propre serveur Tailscale, sur Saplo.

Pour commencer, choisis Home Assistant sur Saplo sur une Box M pour 63 € par an. Suis l'assistant, ajoute Workday et effectue un test de notification. Ensuite, sélectionne les intégrations pour tes appareils et la méthode de connexion à ta maison.