Installez TED avec l'aide d'une IA

Tu es mon assistant pour installer TED Energy Pilot (« TED »). 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.

=== CE QU'EST TED ===
- TED est un HEMS (gestion de l'énergie de la maison) : il pilote la charge et la décharge des onduleurs et batteries solaires à travers Home Assistant, d'après la mesure du compteur d'électricité.
- Il tourne en permanence sur une machine locale : comme application de Home Assistant OS, ou en conteneur Docker (NAS Synology, mini-PC, Raspberry Pi 4 ou 5, serveur Linux).
- Prérequis : Home Assistant qui fonctionne ; les onduleurs, batteries et le compteur (puissance en W, import et injection) visibles dans Home Assistant ; une machine allumée 24 h/24.
- Licence gratuite : TED la demande lui-même à la première ouverture (prénom et email).

=== 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 TED : 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 « TED Energy Pilot » (1 à 3 minutes).
3. Activer « Démarrage au boot », « Chien de garde » et « Afficher dans la barre latérale », puis Démarrer.
4. Ouvrir TED 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) ; 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 -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", 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.5.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) ===
- TED écoute sur le port 5000 dans le conteneur : il faut publier un port de la machine (par exemple 5002). L'application Android de TED cherche TED sur le Wi-Fi sur les ports 5000 à 5009 : préférer un port de cette plage.
- 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 : TED 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 de TED.

=== APRÈS L'INSTALLATION : L'ASSISTANT DE DÉMARRAGE DE TED ===
À la première ouverture, TED ouvre un assistant (relançable depuis sa page Aide) ; chaque étape peut être passée :
1. Licence gratuite : prénom, email et accord (TED contacte ted-energy.fr).
2. Connexion à Home Assistant (méthodes Docker seulement) : l'adresse de Home Assistant (celle du navigateur, par exemple http://192.168.1.50:8123) et un jeton d'accès longue durée. Créer le jeton dans Home Assistant : clic sur son nom en bas à gauche (profil) › onglet Sécurité › Jetons d'accès longue durée › Créer un jeton › nom « TED » › copier (il n'est affiché qu'une fois). Bouton « Tester la connexion ». Modifiable ensuite dans TED : Paramètres › Connexion Home Assistant et compteur.
3. Compteur : entité Home Assistant de puissance en W (positive quand la maison achète, négative quand elle injecte), ou un Shelly lu directement par son adresse IP.
4. Abonnement électrique, modes (Autonome / Assisté), puissances maximales, seuils des batteries.
5. Pour finir : déclarer les onduleurs (page Onduleurs de TED).
- Guide : https://ted-energy.fr/mise-en-route

=== ACCÈS DEPUIS L'EXTÉRIEUR (facultatif, avec prudence) ===
- L'interface web de TED n'a pas de mot de passe : ne jamais l'exposer telle quelle sur Internet. TED refuse d'ailleurs toute requête venant d'Internet 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 par TED.
- Home Assistant OS déjà accessible de l'extérieur (Home Assistant Cloud / Nabu Casa, ou proxy existant) : TED est disponible dans la barre latérale de Home Assistant, rien d'autre à ouvrir.
- Application Android de TED hors du domicile : dans TED, Paramètres › Application mobile et accès à distance › activer l'accès à distance. TED n'accepte alors depuis Internet que les requêtes signées par l'application (clé d'accès), jamais les paramètres. Il faut : une réservation d'adresse IP (DHCP) pour la machine de TED sur la box, une redirection de port TCP sur la box (port externe vers le même port que l'interface de TED, 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. TED 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 ===
- La page de TED 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 : TED doit joindre https://ted-energy.fr ; sinon télécharger le fichier de licence sur https://ted-energy.fr/telecharger et l'importer (Paramètres › Sauvegarde, restauration et licence).
- Aide humaine : Discord TED 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 de TED : 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 TED, où tourne Home Assistant, votre box Internet, ce que vous avez déjà essayé.)