Guide d'installation
Installez TED en quelques minutes
Trois méthodes selon votre matériel : Windows sans rien installer, NAS Synology avec un script guidé, ou Docker sur mesure. Vos réglages restent chez vous, sur votre machine.
À préparer avant de commencer
- Home Assistant fonctionnel et accessible sur votre réseau local.
- L'intégration Zendure pour Home Assistant, installée et opérationnelle.
- Un jeton d'accès longue durée Home Assistant : Profil › Sécurité › Jetons d'accès longue durée › Créer un jeton.
- Un compteur Shelly qui mesure le réseau (lu via Home Assistant ou en direct par IP).
Windows portable Le plus simple
Idéal pour essayer TED sur un PC Windows 10 ou 11, sans Docker ni installation.
- 1
Téléchargez les fichiers
TED_Portable_Windows.zip(15 Mo) et votre licence, depuis la page Télécharger. - 2
Dézippez l'archive
Clic droit sur le fichier › Extraire tout…, dans un dossier de votre choix (par exemple
C:\TED). Ne lancez pas TED depuis l'intérieur du zip. - 3
Renseignez Home Assistant
Dans le dossier extrait, ouvrez
ha_url.txtet remplacezhttp://CHANGE_ME:8123par l'adresse de votre Home Assistant (ex.http://192.168.1.10:8123). Collez ensuite votre jeton dansha_token.txt. - 4
Lancez TED
Double-cliquez sur Lancer TED.bat : l'interface s'ouvre dans votre navigateur. Si un réglage manque, le lanceur ouvre directement les deux fichiers à compléter.
- 5
Importez votre licence
Dans l'interface, onglet Paramètres, importez le fichier
ted-license-….json. Passez ensuite à la mise en route.
Avertissement Windows SmartScreen ? C'est normal pour un programme récent : après avoir vérifié qu'il vient bien de ce site, cliquez sur « Informations complémentaires » puis « Exécuter quand même ».
Synology / NAS Recommandé 24 h/24
Le script fourni charge l'image, crée les dossiers et le réseau Docker, lit votre jeton Home Assistant et démarre TED.
- 1
Déposez les fichiers sur le NAS
Téléchargez
ted-bot-v2.3.tar.gz,install_ted_prebuilt.shet votre licence, puis copiez l'image et le script dans/volume1/docker/ted-bot(par exemple avec File Station). - 2
Connectez-vous en SSH
Sur Synology : Panneau de configuration › Terminal et SNMP › activer le service SSH, puis connectez-vous au NAS depuis un terminal.
- 3
Lancez l'installation
Collez le bloc ci-dessous en remplaçant
COLLER_ICI_VOTRE_TOKEN_HApar votre jeton. Adaptez l'adresse de Home Assistant et le réseau Docker si besoin. - 4
Ouvrez l'interface
Rendez-vous sur
http://IP-DU-NAS:5001, importez votre licence dans Paramètres, puis suivez la mise en route.
cd /volume1/docker/ted-bot
mkdir -p runtime logs
printf "%s\n" "COLLER_ICI_VOTRE_TOKEN_HA" > ha_token.txt
sudo CONTAINER_NAME=ted-bot \
BASE_DIR=/volume1/docker/ted-bot \
HA_TOKEN_FILE=/volume1/docker/ted-bot/ha_token.txt \
NETWORK_NAME=iot-net \
IMAGE_ARCHIVE=./ted-bot-v2.3.tar.gz \
SKIP_PULL=1 \
HA_URL=http://homeassistant:8123 \
INTERACTIVE_PATH_PROMPT=0 \
INTERACTIVE_NETWORK_PROMPT=0 \
INTERACTIVE_HA_TOKEN_PROMPT=0 \
bash install_ted_prebuilt.shsudo docker ps --filter name=ted-bot
sudo docker logs --tail 80 ted-botDocker avancé Intégrateurs
Sans script, uniquement avec Docker : vous gardez la main sur le réseau, les ports et les volumes.
- 1
Préparez l'environnement
Créez vos dossiers persistants (
runtimeetlogs), choisissez le réseau Docker partagé avec Home Assistant et le port d'exposition. - 2
Chargez l'image
À partir de l'archive
ted-bot-v2.3.tar.gz(48 Mo). - 3
Lancez le conteneur
Avec vos variables d'environnement et vos volumes, puis ouvrez l'interface exposée.
gunzip -c ted-bot-v2.3.tar.gz | sudo docker loadsudo docker rm -f ted-bot >/dev/null 2>&1 || true
sudo docker run -d \
--name ted-bot \
--network iot-net \
--restart unless-stopped \
-p 5001:5000 \
-e DEPLOYMENT_ENV=docker \
-e HA_URL=http://homeassistant:8123 \
-e HA_TOKEN="VOTRE_TOKEN_HA" \
-e WEB_PORT=5000 \
-e LOGS_DIR=/data/logs \
-e RUNTIME_FILES_DIR=/data/runtime \
-v /volume1/docker/ted-bot/runtime:/data/runtime \
-v /volume1/docker/ted-bot/logs:/data/logs \
ted-bot:latest python app_web.pycDépannage
Un souci pendant l'installation ?
L'interface de TED ne s'ouvre pas
Sur Windows, vérifiez que ha_url.txt et ha_token.txt sont bien remplis (le lanceur les rouvre sinon) et que TED n'a pas été lancé depuis le zip. Sur Docker, consultez les journaux avec sudo docker logs --tail 80 ted-bot.
Le test de connexion à Home Assistant échoue
Vérifiez que l'adresse de Home Assistant est joignable depuis la machine qui fait tourner TED et que le jeton est valide et complet. En Docker, le conteneur doit être sur le même réseau que Home Assistant (NETWORK_NAME) ou utiliser son adresse IP (HA_HOST_IP).
Le port 5001 est déjà utilisé sur mon NAS
Ajoutez HOST_WEB_PORT=5002 (ou un autre port libre) à la commande d'installation, puis ouvrez l'interface sur ce port.
Où importer ma licence ?
Dans l'interface de TED, onglet Paramètres. Si vous avez perdu le fichier, refaites une demande sur la page Télécharger avec la même adresse email.
Toujours bloqué ? Demandez de l'aide sur Discord
TED est lancé ? Passez à la mise en route.
Licence, Home Assistant, compteur et premiers onduleurs : la configuration initiale expliquée pas à pas.