TedEnergy
English

Installation › Ligne de commande

Guide · Docker en ligne de commande

Installer TedEnergy en ligne de commande

Pour les habitués de Docker : NAS (Synology en SSH, QNAP…), mini-PC, Raspberry Pi 4 ou 5, serveur Linux. L'image publique tedenergy/ted existe pour Intel / AMD et ARM64 : Docker prend la bonne.

  1. 1

    Créez le dossier de données

    Il gardera réglages, licence, historique et journaux d'une version à l'autre. Exemple sur un Synology ; sur un PC ou un Raspberry Pi, ~/ted convient.

    Dossier de données 
    sudo mkdir -p /volume1/docker/ted
  2. 2

    Lancez le conteneur

    Deux ports et un dossier suffisent : aucune variable à renseigner.

    Lancer le conteneur 
    sudo docker run -d \
  --name ted-bot \
  --restart unless-stopped \
  -p 5002:5000 \
  -p 1885:1885 \
  -v /volume1/docker/ted:/data \
  tedenergy/ted:latest
  3. 3

    Ouvrez l'interface

    http://IP-DE-LA-MACHINE:5002 : l'assistant de démarrage demande la licence gratuite, puis l'adresse de Home Assistant et un jeton d'accès longue durée (Home Assistant › votre profil › Sécurité › Jetons d'accès longue durée). Ensuite, la mise en route.

Avec Docker Compose

docker-compose.yml 
services:
  ted:
    image: tedenergy/ted:latest
    container_name: ted-bot
    restart: unless-stopped
    ports:
      - "5002:5000"
      - "1885:1885"
    volumes:
      - ./ted:/data
Démarrer 
sudo docker compose up -d

Mise à jour

Mettre à jour le conteneur

Récupérez l'image, puis recréez le conteneur avec la même commande : vos données restent dans le dossier monté sur /data.

docker run 
sudo docker pull tedenergy/ted:latest
sudo docker rm -f ted-bot
# puis relancez la commande de l'étape 2
Docker Compose 
sudo docker compose pull && sudo docker compose up -d

Sans Docker Hub

Installation hors ligne

Pour une machine sans accès à Docker Hub : téléchargez l'archive de l'image sur la page Télécharger, ted-bot-v3.8.1.tar.gz (99 Mo) pour Intel / AMD ou ted-bot-v3.8.1-arm64.tar.gz pour ARM64.

Charger l'image et lancer le conteneur 
gunzip -c ted-bot-v3.8.1.tar.gz | sudo docker load
sudo docker run -d --name ted-bot --restart unless-stopped \
  -p 5002:5000 -p 1885:1885 -v /volume1/docker/ted:/data ted-bot:latest

Les deux archives se chargent sous le nom ted-bot:latest. Le script install_ted_prebuilt.sh de la page Télécharger fait ces étapes en une fois (il demande aussi le jeton Home Assistant) : il vérifie les ports, propose un port libre si l'un d'eux est déjà pris (interface entre 5001 et 5009, MQTT 1885 ou suivant) et garde les mêmes à chaque mise à jour. Pour imposer le port MQTT : HOST_MQTT_PORT=1890 devant la commande (0 pour ne pas le publier). Mise à jour : chargez la nouvelle archive, puis recréez le conteneur.

Dépannage

Un souci ?

Le conteneur tourne-t-il ? 
sudo docker ps --filter name=ted-bot
sudo docker logs --tail 80 ted-bot
« Home Assistant injoignable » dans l'assistant

Utilisez l'adresse IP de Home Assistant avec son port (http://192.168.1.50:8123) : homeassistant.local n'est pas toujours connu dans un conteneur.

Le port 5002 est déjà utilisé

Remplacez -p 5002:5000 par un autre port libre (de préférence entre 5003 et 5009) et ouvrez l'interface sur ce port.

Le port 1885 (MQTT) est déjà utilisé, ou manque au conteneur

Docker ne permet pas d'ajouter un port à un conteneur existant : supprimez-le (sudo docker rm -f ted-bot, vos données restent dans le dossier) et relancez la commande de l'étape 2. Si 1885 est pris, remplacez -p 1885:1885 par un autre port libre, par exemple -p 1890:1885, puis indiquez 1890 dans Paramètres › Connecteurs d'appareils › Serveur MQTT intégré (étape 2 de la mise en service). Le script d'installation hors ligne fait ce choix tout seul.

Accès depuis l'extérieur

N'exposez jamais l'interface sur Internet : préférez un VPN. Pour l'application mobile hors de chez vous, activez l'accès à distance (Paramètres › Application mobile et accès à distance) : seules les requêtes signées par l'application sont alors acceptées, et le mode opératoire s'affiche.

Toujours bloqué ? Faites-vous guider par une IA · Discord

C'est lancé ? Passez à la mise en route.

L'assistant de démarrage, puis vos premiers onduleurs : tout est expliqué.

Voir la mise en route Poser une question sur Discord
Télécharger gratuitement