Guide d'installation
Installez TED en quelques minutes
Deux méthodes selon votre matériel : 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.
- Vos onduleurs et batteries visibles dans Home Assistant, via l'intégration de leur marque.
- 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 d'électricité dont la mesure (import et injection) remonte dans Home Assistant, ou un Shelly lu en direct par IP.
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-v3.1.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.
NAS à processeur ARM ? Téléchargez l'image ARM64 (ted-bot-v3.1-arm64.tar.gz) et indiquez ce nom de fichier dans IMAGE_ARCHIVE : le reste est identique.
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-v3.1.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.sh
sudo docker ps --filter name=ted-bot
sudo docker logs --tail 80 ted-bot
Docker 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-v3.1.tar.gz(48 Mo). - 3
Lancez le conteneur
Avec vos variables d'environnement et vos volumes, puis ouvrez l'interface exposée.
Freebox, Raspberry Pi ou autre processeur ARM ? Chargez l'image ARM64 (ted-bot-v3.1-arm64.tar.gz) à la place : elle se charge elle aussi sous le nom ted-bot:latest, les commandes ne changent pas. Sur Freebox Delta ou Ultra, créez d'abord une machine virtuelle Debian ou Ubuntu dans Freebox OS et installez-y Docker.
gunzip -c ted-bot-v3.1.tar.gz | sudo docker load
sudo 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.pyc
Dépannage
Un souci pendant l'installation ?
L'interface de TED ne s'ouvre pas
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.