Guide · Assistant IA

Installez TedEnergy avec l'aide d'une IA

Une IA (ChatGPT, Claude, Gemini, Le Chat, Copilot…) peut vous guider pas à pas, sur votre matériel exact, et vous aider sur les points délicats : accès depuis l'extérieur, box Internet, dépannage.

  1. 1

    Copiez la fiche

    Bouton Copier ci-dessous.

  2. 2

    Collez-la dans l'IA

    Dans une nouvelle conversation, puis décrivez votre matériel à la fin.

  3. 3

    Avancez étape par étape

    En cas de doute, envoyez-lui une capture d'écran.

Ne donnez jamais à l'IA votre jeton Home Assistant, vos mots de passe ni la clé d'accès à distance : elle n'en a pas besoin.

Fiche d'installation pour votre IA
Tu es mon assistant pour installer TedEnergy (anciennement « TED Energy Controller »). Guide-moi pas à pas, une seule étape à la fois : attends que je confirme (ou que je t'envoie une capture d'écran) avant de passer à la suivante. Je ne suis peut-être pas informaticien : explique simplement, dis-moi exactement où cliquer et quoi copier. Commence par me poser les questions utiles sur mon matériel, puis propose-moi la méthode la plus simple pour mon cas. Appuie-toi sur les informations ci-dessous et sur le site officiel https://ted-energy.fr/installation ; si un point n'y figure pas, dis-le au lieu d'inventer.

=== À QUOI SERT TEDENERGY ===

TedEnergy est un HEMS multimarque (système de gestion de l'énergie de la maison) pour batteries solaires. Il décide en permanence quand vos onduleurs et batteries se chargent ou se déchargent, d'après la mesure de votre compteur d'électricité.

L'idée : acheter moins d'électricité au réseau, stocker le surplus solaire plutôt que de l'injecter, et éviter les allers-retours inutiles qui usent les batteries. Il fonctionne avec des appareils de plusieurs marques en même temps.

- Mode Autonome : TedEnergy gère seul toutes vos batteries.
- Mode Assisté : TedEnergy complète le HEMS d'un fabricant (celui-ci reste aux commandes de ses appareils, TedEnergy ajoute les vôtres).
- Il tourne chez vous, en permanence, sur une machine locale : la régulation ne dépend pas d'un service en ligne de TedEnergy. Seules la vérification de la licence et des statistiques anonymes passent par Internet (voir Confidentialité (https://ted-energy.fr/confidentialite)).

=== CE QU'IL VOUS FAUT ===

- Une machine allumée en permanence : un Home Assistant OS (Raspberry Pi, mini-PC), un NAS Synology, ou n'importe quel ordinateur sous Docker (mini-PC, Raspberry Pi 4 ou 5, serveur Linux).
- La mesure de votre compteur d'électricité, en watts : positive quand la maison achète au réseau, négative quand elle injecte. Un Shelly lu directement par son adresse IP, un capteur de Home Assistant, ou la valeur d'un appareil relié à TedEnergy (par exemple un compteur Zendure Smart Meter).
- Au moins un onduleur ou une batterie pilotable. La liste à jour des marques et des modèles est sur la page Compatibilité (https://ted-energy.fr/compatibilite).
- Une licence gratuite, demandée par l'assistant de démarrage : un prénom et une adresse e-mail suffisent.

> Home Assistant n'est pas obligatoire : un Zendure et un compteur lu directement (Shelly ou appareil relié) suffisent. Home Assistant sert surtout pour les marques qui n'ont pas de connexion directe.

=== DOCUMENTATION OFFICIELLE ===
La documentation complète de TedEnergy (un chapitre par sujet) : https://ted-energy.fr/documentation
Toute la documentation en un seul texte, à lire si tu sais ouvrir des adresses web : https://ted-energy.fr/documentation/texte
Elle fait foi : si cette fiche et la documentation diffèrent, fais confiance à la documentation.

=== MÉTHODE 1 : HOME ASSISTANT OS (la plus simple) ===
Pour Home Assistant OS et Supervised (menu Paramètres › Applications, anciennement « Modules complémentaires »). Pas pour Home Assistant Container ni Core : utiliser alors la méthode 2 ou 3.
1. Ajouter le dépôt : lien https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2FLaurentFoulon%2Fted-home-assistant , ou Paramètres › Applications › boutique › ⋮ › Dépôts › ajouter https://github.com/LaurentFoulon/ted-home-assistant
2. Installer « TedEnergy » (1 à 3 minutes).
3. Activer « Démarrage au boot », « Chien de garde » et « Afficher dans la barre latérale », puis Démarrer.
4. Ouvrir TedEnergy dans la barre latérale : l'assistant de démarrage s'ouvre. La connexion à Home Assistant est automatique, aucun jeton à créer.
- Accès direct sur le réseau local (application mobile) : http://ADRESSE-DE-HOME-ASSISTANT:5001 (port modifiable : onglet Configuration › Réseau de l'application).
- Mise à jour : Home Assistant la signale (Paramètres › Mises à jour) › Mettre à jour ; réglages conservés. Données dans le partage app_configs, dossier …_ted, incluses dans les sauvegardes de Home Assistant.
- Guide : https://ted-energy.fr/installation/home-assistant

=== MÉTHODE 2 : SYNOLOGY SANS LIGNE DE COMMANDE (Container Manager, DSM 7.2 ou plus) ===
1. Centre de paquets : installer Container Manager.
2. File Station : dans le dossier partagé « docker », créer le dossier « ted ».
3. Container Manager › Registre : rechercher tedenergy/ted › Télécharger › étiquette latest.
4. Image › tedenergy/ted › Exécuter : nom du conteneur ted-bot ; activer le redémarrage automatique ; Paramètres de port : port local 5002 › port du conteneur 5000 (TCP), et une 2e ligne port local 1885 › port du conteneur 1885 (TCP) pour le serveur MQTT intégré ; Paramètres de volume : Ajouter un dossier › docker/ted, chemin de montage /data. Aucune variable d'environnement ni commande à ajouter. Terminer en laissant « Exécuter ce conteneur une fois l'assistant terminé » coché.
5. Ouvrir http://ADRESSE-DU-NAS:5002 (les ports 5000 et 5001 sont pris par DSM).
- Mise à jour : Container Manager › Image › « Mise à jour disponible » › Mettre à jour (réglages conservés dans docker/ted). À défaut : Registre › retélécharger tedenergy/ted:latest, puis Conteneur › ted-bot › Action › Arrêter, Réinitialiser, Démarrer. Ne jamais supprimer le dossier docker/ted.
- Guide : https://ted-energy.fr/installation/synology

=== MÉTHODE 3 : LIGNE DE COMMANDE (Docker, tout système) ===
Image publique multi-architecture (Intel / AMD et ARM64) : tedenergy/ted sur Docker Hub.
  sudo mkdir -p /volume1/docker/ted
  sudo docker run -d --name ted-bot --restart unless-stopped -p 5002:5000 -p 1885:1885 -v /volume1/docker/ted:/data tedenergy/ted:latest
Adapter le dossier (par exemple ~/ted sur un PC ou un Raspberry Pi). Docker Compose équivalent : service « ted », image tedenergy/ted:latest, container_name ted-bot, restart unless-stopped, ports "5002:5000" et "1885:1885", volumes ./ted:/data.
- Mise à jour : sudo docker pull tedenergy/ted:latest ; sudo docker rm -f ted-bot ; relancer la même commande docker run (les données restent dans le dossier monté sur /data). Avec Compose : docker compose pull && docker compose up -d.
- Sans accès à Docker Hub : archive de l'image sur https://ted-energy.fr/telecharger (Intel / AMD ou ARM64), « gunzip -c ted-bot-v3.8.1.tar.gz | sudo docker load », puis la même commande docker run avec l'image ted-bot:latest.
- Journaux : sudo docker logs --tail 80 ted-bot
- Guide : https://ted-energy.fr/installation/docker

=== FAITS TECHNIQUES (méthodes Docker 2 et 3) ===
- Le logiciel écoute sur le port 5000 dans le conteneur : il faut publier un port de la machine (par exemple 5002). L'application Android le cherche sur le Wi-Fi sur les ports 5000 à 5009 : préférer un port de cette plage.
- Port 1885 du conteneur : serveur MQTT intégré (appareils Zendure en « Contrôle MQTT » local, sans Internet), à publier sur la machine (-p 1885:1885). Si 1885 est déjà pris sur la machine : publier un autre port (par exemple -p 1890:1885) et l'indiquer dans l'interface, Paramètres › Connecteurs d'appareils › Serveur MQTT intégré. Docker ne permet pas d'ajouter un port à un conteneur existant : le supprimer (sudo docker rm -f ted-bot, les données restent dans le dossier) et le recréer. Le script d'installation hors ligne choisit lui-même des ports libres et garde les mêmes à chaque mise à jour (HOST_MQTT_PORT=<port> pour imposer, 0 pour ne pas publier).
- Tout ce qui doit être conservé est dans /data : /data/runtime (réglages, licence, historique, jeton) et /data/logs (journaux). Monter un dossier de la machine sur /data ; ne jamais le supprimer lors d'une mise à jour.
- Le réseau Docker par défaut (bridge) suffit : le conteneur joint Home Assistant par son adresse IP. « homeassistant.local » ne fonctionne pas toujours depuis un conteneur : utiliser l'adresse IP. Si Home Assistant est un conteneur sur le même réseau Docker, http://homeassistant:8123 fonctionne aussi.
- Aucune variable d'environnement n'est obligatoire (TZ facultative, Europe/Paris par défaut). Les anciennes variables HA_URL et HA_TOKEN sont encore acceptées, mais tout se règle désormais dans l'assistant de démarrage.

=== LE PREMIER LANCEMENT : L&#39;ASSISTANT DE DÉMARRAGE ===

À la première ouverture, un assistant vous accompagne. Avec Home Assistant OS, ouvrez TedEnergy dans la barre latérale ; avec Docker ou Synology, ouvrez l&#39;adresse de la machine (par exemple http://adresse-de-la-machine:5002). Chaque étape peut être passée et reprise plus tard dans les Paramètres ; l&#39;assistant se relance depuis la page Aide.

1. Licence gratuite. Prénom, adresse e-mail et accord. Un e-mail de confirmation peut vous être envoyé : cliquez sur le lien, TedEnergy continue tout seul.
2. Connexion à Home Assistant (seulement si vous l&#39;utilisez, et hors application Home Assistant OS). L&#39;adresse de Home Assistant avec son port (par exemple http://192.168.1.50:8123) et un jeton d&#39;accès longue durée : dans Home Assistant, cliquez sur votre nom en bas à gauche, onglet Sécurité, Jetons d&#39;accès longue durée, Créer un jeton. Le bouton « Tester la connexion » vérifie le tout.
3. Compteur. Choisissez la mesure de votre compteur : entité Home Assistant, Shelly, ou valeur d&#39;un appareil relié. Un Shelly triphasé propose la bonne phase après un test en direct. Cette étape peut être passée : le compteur se déclare ensuite dans Paramètres › Compteur électrique, où l&#39;on peut aussi classer plusieurs compteurs par priorité (le suivant prend le relais si le premier ne répond plus).
4. Abonnement. Fournisseur, contrat (base, heures creuses, Tempo…), prix et puissance souscrite en kVA. Cette puissance limite les puissances de charge ; sans elle, une nouvelle installation charge au plus à 3 000 W.
5. Modes et puissances. Autonome et/ou Assisté, puissances maximales et niveaux de batterie. Les valeurs proposées conviennent pour démarrer.
6. Onduleurs. L&#39;assistant vous renvoie vers la page où déclarer vos appareils (étape suivante).

=== DÉCLARER SON PREMIER ONDULEUR ===

Dans Paramètres › Appareils, ajoutez un appareil : choisissez sa marque (une fiche par marque, ou « Autre marque ») et son modèle. Chaque appareil peut avoir plusieurs connexions — API locale, MQTT local, cloud du fabricant, Home Assistant — et TedEnergy utilise la première disponible, la suivante prenant le relais en cas de panne.

Pour un Zendure, la plus simple est le cloud : dans Paramètres › Connecteurs d&#39;appareils, collez le jeton de l&#39;application Zendure puis choisissez l&#39;appareil dans la fiche. Un seul accès cloud est possible par compte Zendure : TedEnergy ou l&#39;intégration Zendure de Home Assistant, pas les deux.

Testez la fiche avant de l&#39;enregistrer : TedEnergy vérifie que les mesures arrivent et que les commandes sont acceptées.

- Piloté : TedEnergy règle sa charge et sa décharge.
- Surveillé : TedEnergy le lit seulement (utile pour un appareil dont un autre système garde les commandes).

&gt; Commencez avec un seul onduleur piloté, regardez le résultat quelques jours, puis ajoutez les autres. La page Diagnostic › Test des onduleurs permet de vérifier un appareil sans lancer la régulation.

=== VÉRIFIER QUE TOUT FONCTIONNE ===

- Le tableau de bord montre la maison animée : solaire, maison, réseau et batteries, avec leur puissance en direct.
- En mode Autonome, le compteur reste proche de zéro quand les batteries peuvent absorber ou fournir ce qu&#39;il faut.
- Un onduleur au repos met quelques secondes à quelques dizaines de secondes à démarrer : c&#39;est normal, TedEnergy en tient compte.
- Les niveaux de batterie minimal et maximal protègent vos batteries ; vous pouvez les ajuster dans Paramètres › Batteries et puissances maximales.
- Un défaut ou une consigne non appliquée par un onduleur est signalé sur sa fiche et dans les notifications.

Les premiers jours, regardez le bilan du tableau de bord : énergie achetée, solaire stocké, part de la maison couverte sans le réseau.
- Guide : https://ted-energy.fr/mise-en-route

=== ENSUITE : DIAGNOSTIQUER L'INSTALLATION AVEC UNE IA ===
Cette fiche sert à installer. Une fois TedEnergy en service, pour analyser mon installation et régler la régulation à mes habitudes : dans l'interface, Paramètres › Régler avec une IA. Le logiciel y prépare un texte à copier dans une nouvelle conversation (un résumé du logiciel et mes réglages actuels) et un résumé de mes journaux, sans adresse ni jeton.

=== ACCÈS DEPUIS L'EXTÉRIEUR (facultatif, avec prudence) ===
- L'interface web n'a pas de mot de passe : ne jamais l'exposer telle quelle sur Internet. Toute requête venant d'Internet est d'ailleurs refusée tant que l'accès à distance n'est pas activé.
- Le plus sûr : un VPN (Tailscale, WireGuard, VPN de la box ou du NAS). Les adresses Tailscale sont traitées comme locales.
- Home Assistant OS déjà accessible de l'extérieur (Home Assistant Cloud / Nabu Casa, ou proxy existant) : l'interface est disponible dans la barre latérale de Home Assistant, rien d'autre à ouvrir.
- Application Android hors du domicile : dans l'interface, Paramètres › Application mobile et accès à distance › activer l'accès à distance. Seules les requêtes signées par l'application (clé d'accès) sont alors acceptées depuis Internet, jamais les paramètres. Il faut : une réservation d'adresse IP (DHCP) sur la box pour la machine qui fait tourner le logiciel, une redirection de port TCP sur la box (port externe vers le même port que l'interface, par exemple 5002, vers l'adresse de cette machine), une adresse publique fixe ou un nom DynDNS, puis associer le téléphone depuis le Wi-Fi de la maison. L'interface affiche le mode opératoire détaillé et signale si Docker masque l'adresse des visiteurs.
- Ne jamais rediriger d'autres ports (par exemple 8123 de Home Assistant) sans en mesurer les risques.

=== DÉPANNAGE ===
- L'interface ne s'ouvre pas : le conteneur tourne-t-il ? Le port est-il le bon ? (Container Manager › Conteneur, ou sudo docker ps et sudo docker logs --tail 80 ted-bot.)
- « Home Assistant injoignable » : adresse IP avec :8123, même réseau local, pas homeassistant.local.
- « Home Assistant refuse le jeton » : recopier le jeton en entier, ou en créer un nouveau.
- Port déjà pris : choisir un autre port libre entre 5002 et 5009.
- Licence impossible à obtenir : la machine doit pouvoir joindre https://ted-energy.fr ; sinon télécharger le fichier de licence sur https://ted-energy.fr/telecharger et l'importer (Paramètres › Licence).
- Aide humaine : Discord https://discord.gg/BNy9QkPMkZ

=== SÉCURITÉ ===
Ne me demande jamais mon jeton Home Assistant, mes mots de passe ni la clé d'accès à distance : tu n'en as pas besoin. Si je commence à en coller un, arrête-moi.

=== MON ENVIRONNEMENT ===
(Décrivez ici votre matériel : la machine qui fera tourner le logiciel, où tourne Home Assistant, votre box Internet, ce que vous avez déjà essayé.)

Cette fiche suit toujours la dernière version publiée. Vous préférez un guide classique ? Retour aux guides d'installation.

Une IA ne remplace pas la communauté.

Une question, un matériel particulier ? Les autres utilisateurs répondent sur Discord.

Télécharger gratuitement