Documentation · 3.8.1

Documentation de TedEnergy

Tout ce qu'il faut pour installer, régler et comprendre TedEnergy : un chapitre par sujet, sans jargon. Lisez seulement ce qui vous intéresse.

Documentation à jour avec TedEnergy 3.8.1.

Démarrer avec TedEnergy

Installer TedEnergy, obtenir sa licence gratuite, déclarer son compteur et son premier onduleur, puis vérifier que tout fonctionne : comptez environ 30 minutes.

À 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é).

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é.
  • 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.

Choisir son installation

Trois méthodes, de la plus simple à la plus libre. Chaque guide détaille les étapes avec des captures :

  • Home Assistant OS : la plus simple. On ajoute le dépôt de l'application, on installe, on démarre. Aucun jeton à créer, la connexion à Home Assistant est automatique.
  • Synology : Container Manager, sans ligne de commande.
  • Docker : une seule commande (ou Docker Compose) sur n'importe quel système.

Une IA peut aussi vous guider pas à pas sur votre matériel exact : voir l'installation avec l'aide d'une IA.

L'interface de TedEnergy n'a pas de mot de passe : ne l'exposez jamais telle quelle sur Internet. Pour y accéder de l'extérieur, utilisez un VPN, ou l'accès à distance de l'application Android (qui n'accepte que des requêtes signées).

Le premier lancement : l'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'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'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'utilisez, et hors application Home Assistant OS). L'adresse de Home Assistant avec son port (par exemple http://192.168.1.50:8123) et un jeton d'accès longue durée : dans Home Assistant, cliquez sur votre nom en bas à gauche, onglet Sécurité, Jetons d'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'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'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'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'appareils, collez le jeton de l'application Zendure puis choisissez l'appareil dans la fiche. Un seul accès cloud est possible par compte Zendure : TedEnergy ou l'intégration Zendure de Home Assistant, pas les deux.

Testez la fiche avant de l'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).

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'il faut.
  • Un onduleur au repos met quelques secondes à quelques dizaines de secondes à démarrer : c'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.

Mises à jour et sauvegarde

  • Home Assistant OS : Home Assistant signale la mise à jour de l'application ; vos réglages sont conservés.
  • Synology et Docker : tirez la nouvelle image et recréez le conteneur avec le même dossier de données (voir le guide de votre méthode).
  • TedEnergy signale lui-même qu'une nouvelle version est disponible (bandeau et badge dans la barre du haut).
  • Paramètres › Sauvegarde et versions : exporter votre configuration, la restaurer, et revenir à une version précédente si la mise à jour vous pose problème.

Ne supprimez jamais le dossier de données de TedEnergy lors d'une mise à jour : il contient vos réglages, votre licence et votre historique.

Obtenir de l'aide

  • Cette documentation : un chapitre par sujet ; la version PDF se télécharge depuis la page d'accueil de la documentation.
  • La communauté : Discord et Facebook.
  • Une IA : dans Paramètres › Régler avec une IA, TedEnergy prépare un texte et un résumé de vos journaux à donner à ChatGPT, Claude, Gemini ou Le Chat. Vous choisissez ce que vous partagez.

Questions fréquentes

Home Assistant est-il obligatoire ?

Non. Zendure fonctionne par son cloud, ou en local par MQTT / API locale, sans Home Assistant. Il sert surtout pour les marques sans connexion directe. TedEnergy fonctionne aussi bien comme application de Home Assistant OS que dans Docker.

TedEnergy est-il gratuit ?

La licence est gratuite pour démarrer. Les limites éventuelles d'une licence (nombre d'onduleurs pilotés, durée) sont indiquées dans Paramètres › Licence et sur la page Soutenir.

Puis-je essayer sans risque ?

Oui. Déclarez d'abord vos appareils en « surveillé » pour voir ce que TedEnergy lit, puis passez-en un seul en « piloté ». Vous pouvez désactiver un onduleur ou toute la régulation à tout moment.

Mon onduleur n'est pas dans la liste.

Choisissez « Autre marque » : la fiche accepte les entités de n'importe quel appareil exposé par Home Assistant ou par MQTT. Si cela ne suffit pas, demandez sur Discord ou Facebook : les marques les plus demandées sont ajoutées en priorité.

Que se passe-t-il si Internet est coupé ?

TedEnergy continue de réguler en local. La licence est revérifiée dès le retour d'Internet, sans blocage entre-temps.

Une question, un cas particulier ? La communauté répond sur Discord et Facebook. Une IA peut aussi analyser votre installation : voir « Régler avec une IA » dans les Paramètres de TedEnergy. Discord · Facebook

Prêt à faire travailler toutes vos batteries ensemble ?

Téléchargement gratuit : votre licence gratuite arrive dès que votre adresse email est confirmée, sans carte bancaire.

Télécharger gratuitement