Guide d'installation · Home Assistant OS
Sur Home Assistant OS, TED s'installe comme une application, sur la même machine que Home Assistant : pas de Docker à manipuler, pas de jeton d'accès à créer, et l'interface de TED dans la barre latérale. Comptez une quinzaine de minutes.
Pour vérifier : si le menu Paramètres de Home Assistant contient une rubrique Applications (ou Modules complémentaires sur les versions antérieures à 2026), vous pouvez suivre ce guide. Le type exact figure dans Paramètres › Système › Réparations › ⋮ › Informations système, ligne « Type d'installation ».
Aucun jeton d'accès longue durée n'est nécessaire : l'application reçoit automatiquement son accès à Home Assistant.
Installation
Sur la page Télécharger, choisissez Home Assistant OS et indiquez votre prénom et votre email. Vous obtenez :
ted-license-….json), à garder sur votre ordinateur ;ted-bot-v3.2-home-assistant.zip (3,2 Mo), identique pour tous les processeurs ;L'application doit se trouver dans le dossier des applications locales de Home Assistant, sous la forme d'un dossier ted contenant config.yaml. Deux façons de faire, au choix.
Méthode A, la plus simple : le Terminal de Home Assistant.
config.yaml, Dockerfile, app…).D=/addons; [ -d /local_apps ] && D=/local_apps; cd "$D" && curl -fL -o ted.zip "https://ted-energy.fr/download/home-assistant/current?token=VOTRE-LIEN-PERSONNEL" && rm -rf ted && unzip -q ted.zip && rm ted.zip && ls tedMéthode B : le partage réseau (Samba).
ted-bot-v3.2-home-assistant.zip : vous obtenez un dossier ted.local_apps de Home Assistant (anciennement addons) : \\homeassistant.local\local_apps dans l'Explorateur de fichiers, ou smb://homeassistant.local/local_apps depuis le Finder (Aller › Se connecter au serveur). Remplacez homeassistant.local par l'adresse IP de Home Assistant si besoin.ted : vous devez obtenir local_apps/ted/config.yaml (et non ted/ted/config.yaml).Home Assistant construit alors l'application sur votre machine : comptez 2 à 10 minutes (plus long sur Raspberry Pi), sans fermer la page.
Dans l'onglet Info de l'application, activez Démarrage au boot, Chien de garde et Afficher dans la barre latérale, puis cliquez sur Démarrer. L'onglet Journal affiche alors « TED … - application Home Assistant ».
L'onglet Configuration est facultatif : journal détaillé (diagnostic), durée de conservation des journaux (14 jours par défaut) et, rubrique Réseau, le port d'accès direct (5001 par défaut).
Cliquez sur TED dans la barre latérale (ou sur Ouvrir l'interface web). Dans TED, page Paramètres › Sauvegarde, restauration et licence › Importer une licence…, choisissez votre fichier de licence.
La connexion à Home Assistant est automatique : dans Paramètres › Connexion Home Assistant et compteur, le bouton Tester doit répondre « Home Assistant répond ». Poursuivez avec la mise en route : compteur, puis onduleurs.
Au quotidien
TED répond aussi sur http://ADRESSE-DE-HOME-ASSISTANT:5001, depuis votre réseau local. C'est cette adresse que l'application Android de TED trouve toute seule sur le Wi-Fi. L'application et le mode opératoire de l'accès à distance sont dans TED : Paramètres › Application mobile et accès à distance.
Téléchargez la nouvelle version (même page, même email) et déposez-la comme à l'étape 2 : la commande du Terminal remplace l'ancienne version. Puis boutique › ⋮ › Rechercher des mises à jour › TED › Mettre à jour. Vos réglages et votre licence sont conservés.
TED range ses données dans le dossier local_ted du partage app_configs (anciennement addon_configs). Les sauvegardes de Home Assistant les incluent, sauf les journaux : restaurer une sauvegarde restaure aussi TED.
Migration
Récupérez vos réglages, vos onduleurs, votre historique et votre licence en copiant le dossier runtime de l'ancienne installation.
Par exemple sudo docker stop ted-bot sur le NAS. Deux TED ne doivent jamais piloter les mêmes onduleurs en même temps.
Suivez les étapes 1 à 4 ci-dessus, démarrez TED une première fois pour créer son dossier, puis cliquez sur Arrêter.
Copiez le contenu de l'ancien dossier runtime (par exemple /volume1/docker/ted-bot/runtime) dans local_ted/runtime du partage app_configs, en remplaçant les fichiers existants.
Vous retrouvez votre configuration et votre licence. L'adresse et le jeton de Home Assistant de l'ancienne installation sont ignorés : la connexion passe désormais par Home Assistant.
Dépannage
Vérifiez que le fichier est bien à l'emplacement local_apps/ted/config.yaml (et non ted/ted/config.yaml). Dans la boutique, refaites ⋮ › Rechercher des mises à jour, puis rechargez complètement la page du navigateur. Les éventuelles erreurs sont dans Paramètres › Système › Journaux, journal « Superviseur ».
curl: (22) ou unzip qui refuse le fichier : votre lien personnel n'est plus valide. Revenez sur la page Télécharger avec la même adresse email et copiez de nouveau la commande. Could not resolve host : Home Assistant n'a pas accès à Internet.
Home Assistant doit pouvoir joindre Internet pendant l'installation et disposer d'au moins 1 Go d'espace libre. Sur Raspberry Pi, la construction peut prendre une dizaine de minutes. En cas d'échec, le détail est dans le journal « Superviseur » (Paramètres › Système › Journaux) ; relancez ensuite Installer.
Dans TED, Paramètres › Connexion Home Assistant et compteur › Tester. Si Home Assistant répond, vérifiez le nom exact des entités dans Home Assistant (Outils de développement › États). Si le test échoue, redémarrez l'application TED et consultez son onglet Journal.
Dans l'onglet Configuration de l'application, rubrique Réseau, indiquez un autre port libre (de préférence entre 5000 et 5009, que l'application mobile explore d'elle-même), enregistrez puis redémarrez TED. L'interface dans la barre latérale n'utilise pas ce port.
Paramètres › Applications › TED Energy Pilot › Désinstaller, puis supprimez le dossier ted des applications locales. Pensez à télécharger votre configuration avant (dans TED : Paramètres › Sauvegarde, restauration et licence).
Toujours bloqué ? Demandez de l'aide sur Discord
Licence, compteur et premiers onduleurs : la configuration initiale expliquée pas à pas.