Everything to know before installing TedEnergy

TedEnergy is a multi-brand HEMS (home energy management system) that runs at home, on your own server (NAS, mini-PC, Raspberry Pi) or in Home Assistant OS. It reads your meter about every two seconds, then adjusts charging and discharging of all your inverters and batteries so they work together, like one big battery. It connects to your devices through the manufacturer's cloud (Zendure), its built-in MQTT server or Home Assistant.

The software sets no limit: our reference installation regulates about ten. The license offered at installation lets you control everything for 30 days; after that, the number of controlled inverters depends on your license (see the Support page). Monitored inverters are never limited. The other limit is your electrical installation, which you frame with the maximum charge and discharge powers.

Yes. In Assisted mode, the original HEMS (for example the Zendure app) keeps control of its devices, and your other inverters are added as reinforcement. In Autonomous mode, the whole installation is regulated by TedEnergy, independently of the manufacturers.

A controlled inverter receives charge and discharge setpoints. A monitored inverter is read without being driven: its battery and power are part of the calculations, without it ever receiving an order. This is what makes Assisted mode possible next to a manufacturer HEMS.

Quite the opposite: on a real day, optimised charging makes almost nine times fewer charge / discharge reversals than a simple split, with a third less running time (a real day, minute by minute). Each battery's minimum and maximum levels are respected, calibration is monitored and an abnormal voltage gap between a battery's cells triggers an alert.

A way of charging introduced with version 3.7.1: two inverters work in opposite directions, at low power. The one with the lowest battery charges, the one with the highest discharges. A surplus goes to the first, a demand to the second, immediately: the meter stays as close to zero as possible, solar surplus is captured and inverters start and stop far less often. It is switched on in Settings › Solar surplus charging (Autonomous mode, at least two controlled inverters). Trade-off: a little energy keeps flowing from one battery to the other. See it at work on a real day, minute by minute.

Yes, with no ads and no account. The Android app shows your home live and lets you act on your inverters, at home on Wi-Fi and remotely, without a VPN: each request is signed with a key unique to your phone. The configuration stays in the web interface.

The software's interface is in French; the English version is coming in a future release. The website is available in French and English.

On the roadmap page: propose your idea or vote for others, with just your email address, which is never displayed. The most requested ideas move to the top of the list.

No. With a Zendure inverter (through the local API, the Zendure cloud or local MQTT) and a meter read directly (Shelly, or any MQTT meter such as the Zendure Smart Meter 3CT), TedEnergy works on its own on any Docker server. Home Assistant is still recommended for other brands, and it is the simplest installation (Home Assistant OS guide).

Yes. Every Zendure inverter linked to the Zendure app is controlled through the Zendure cloud, including the Hyper 2000, the SolarFlow Hub 1200 / 2000, the AIO 2400 and the ACE 1500, which have no local communication. Every Zendure model is used and validated by our users. One connection per Zendure account: TedEnergy or Home Assistant's Zendure integration (TedEnergy then republishes its values to Home Assistant).

Every Zendure through the cloud; devices that speak MQTT (Zendure over local MQTT, OpenDTU, ESPHome…); and any inverter or battery controllable from Home Assistant (Marstek, EcoFlow, Huawei, Victron, Sungrow, SolarEdge, Deye, Fox ESS, SolaX, Sigenergy, Growatt, Anker SOLIX, Indevolt…). Each brand has its form in the software, and the Other brand form accepts every control method: two setpoints, setpoint and selector, signed setpoint or actions. The grid measurement comes from a Shelly read directly or any power sensor. Model-by-model details are on the Compatibility page.

Yes, that is precisely the goal: all your inverters, whatever the brand, receive a single setpoint, shared according to their power and charge level. See how to make several brands together work, and the other problems solved on the Solutions page.

TedEnergy can talk to a Zendure in four ways. The local API (recent SolarFlow units) and local MQTT stay at home, without the Internet; the Zendure cloud suits every model, Hyper 2000 included; Home Assistant remains possible with the Zendure integration. A Zendure account only accepts one cloud connection at a time: TedEnergy or Home Assistant's Zendure integration. Everything is set in Paramètres (Settings) › Connecteurs d'appareils; check the Compatibility page for your model.

Yes, if your charger's Home Assistant integration exposes a current setpoint and a switch (the case for many Wallbox, Easee, Peblar or OCPP chargers). TedEnergy does not talk to the charger directly: it uses those entities. In the “EV charger” equipment form, tick control and choose your conditions: favourable hours, solar surplus (with threshold and delay), or a departure time with a guaranteed level. The car is never charged by draining the home batteries. A read-only charger (for example the Tesla Wall Connector) is monitored but not controlled. Discharging the car into the home (V2G) is experimental and needs a compatible charger and car.

Yes: in Paramètres › Appareils (Devices), an inverter is declared once with one or more connections (local API, local MQTT, cloud, Home Assistant). TedEnergy uses the first available one, switches to the next after 30 seconds of failure and returns to the preferred one after 5 stable minutes. Automations rely on stable device values that do not change if you change connection.

Yes, through TedEnergy's IsyPower connector (local API, without Home Assistant or the Internet): enable the local API in the IsyPower app, then Paramètres › Connecteurs d'appareils › IsyPower. For a Titan 2400, declare your LINK modules: they set the maximum power (1,000 W when discharging for a Titan alone, up to 2,400 W with LINK modules).

These brands are controlled over Modbus TCP on the local network, but the published register maps differ from one model to another. In TedEnergy, Diagnostic › Sonde Modbus reads your device's registers, read-only (nothing is written to the device, and only a local network address is accepted). Keep remote support open (Paramètres › Assistance et accès à distance) so that we can rerun the probe, then write to contact@ted-energy.fr with the brand, the exact model and the firmware version. Several users of different brands let us make the Modbus TCP connector of each one reliable.

With the Car charging automation template: while the charger is charging, the batteries do not discharge into the car, and solar surplus keeps filling them. Declare your charger on the Appliances page: its power, the energy charged and the car's level can be used as conditions.

Using the batteries so that the house never exceeds your contracted power. With an automation, keep for instance 30% in reserve in the batteries and only use it when consumption exceeds your contracted power: the breaker no longer trips, and you can sometimes lower your contract.

Yes, with automations: a condition on the battery or inverter temperature can limit charging or impose a maximum level; a condition on the day of the week can impose a full charge (maximum level at 100%) on Sundays, for example. Scheduled off-peak charging works for this too.

It follows them: declared on the Appliances page, they appear in the 3D house, the summary and the PDF reports (energy, share of the house, solar or grid origin, cost). Their values are conditions in your automations, which can switch them on or off (water heater on surplus, for example) through Home Assistant or a webhook. The car charging itself is not controlled.

Yes: automations can be sorted into folders (one level). When two automations target the same setting with different values, each is flagged and gets a priority (1 wins). Each automation can also send a phone notification, and you can browse its history and simulate it on the past.

Yes: the weather forecast (Paramètres › Mon installation) estimates your production from the weather (Open-Meteo, MET Norway) and learns your panels' real yield over 14 days. It provides variables (meteo.*) usable in automations, for example “if the coming day is weak, charge the night before”. Only rounded coordinates (about 1 km) are sent to these weather services, with no identifier; the feature can be switched off. A forecast remains indicative, with no guarantee of results.

Yes. An equipment's power can come from a reading in W, from an energy meter in kWh (power is derived from its change over a few minutes, and the logged energy is the meter's), from a current in A multiplied by the voltage, or from a fixed power when the device is running. An estimated power is marked with “≈”.

On an always-on machine. Home Assistant OS: an app added in a few clicks (Home Assistant OS guide). Synology NAS: entirely with the mouse in Container Manager (Synology guide). Docker: one command on a mini-PC, a Raspberry Pi or a Linux server (public image tedenergy/ted on Docker Hub). To discover it without installing anything, open the show home. Everything is explained in the installation guide.

With Docker Hub, Container Manager or Home Assistant OS, nothing to choose: the right version is picked automatically. For an offline archive, take the one matching the machine's processor. Intel / AMD: most Synology NAS, PCs and mini-PCs. ARM64: Raspberry Pi 4 or 5, Freebox Delta or Ultra (in a virtual machine), ARM NAS. If in doubt, the command uname -m shows x86_64 (Intel / AMD) or aarch64 (ARM64). Both images are on the Download page.

A few minutes: a few clicks in Home Assistant OS, about ten minutes with the mouse on a Synology, or a single command with Docker. A wizard then guides you: license, Home Assistant (optional), meter, contract. Zendure inverters are then linked through the cloud (Settings › Connecteurs d'appareils, Zendure app token).

Yes: the Install with an AI page offers a complete sheet to paste into ChatGPT, Claude, Gemini or Le Chat. The AI then guides you step by step on your hardware. Never give it your tokens or passwords. Once installed, Settings › Tune with an AI prepares a summary of your settings and logs to get tailored advice.

Without losing anything: your settings, license and history stay in the data folder, and the interface tells you when a new version is out. Home Assistant OS: click Update (or turn on automatic updates). Synology: Container Manager › Image › Update available › Update. Docker: docker pull tedenergy/ted:latest, then recreate the container with the same command. Details in the installation guide.

Yes, from the interface (Paramètres (Settings) › Sauvegarde et versions). Every version embeds the previous ones: pick one, apply, the software restarts. The page tells you what going back will lose, and greys out the versions that are incompatible with your data, giving the reason. If the chosen version does not start, TedEnergy goes back to the previous one by itself with your earlier configuration. Configuration backups are labelled with the versions that can use them.

Nothing, until further notice. At installation, a license is offered so you can use every feature for 30 days. You can support the project through the fundraiser: some rewards come with a license with extended rights, for the duration shown on the fundraiser. Details on the Support page.

Nothing to do: the license stays valid, with reduced rights. Regulation goes on; only the first controlled inverters in the list still receive setpoints. A warning is shown a week before: you can then request an extension or contribute to the fundraiser.

Choose a reward on the fundraiser and write the email address of your ted-energy.fr account in your contribution message: your license is updated with the reward's rights, and you receive a confirmation email. No account yet? One is created for your address. Everything is explained on the Support page.

At any time, in the software's interface (Settings › License › Request an extension) or on the Extend my license page: enter the duration you need in days and a few words of explanation. The answer arrives by email and, if approved, the new date is applied automatically.

A license is used on one machine. If you reinstall the software elsewhere (new NAS, moving from Docker to Home Assistant OS…), transferring the license is offered at first start-up: the old machine is then permanently blocked. A machine that no longer checks its license for 2 months also frees its slot. For a company, association or local authority, multi-machine licenses exist: contact us.

No. The license is offered at the software's first start: enter your first name and email address, then confirm it (link received by email): it is then obtained and activated automatically. The Download page is still available to download the license file and import it by hand.

With your license, a ted-energy.fr account is created: an email asks you to confirm your address and gives you a temporary password. It protects your license: if you install the software on another machine, it is asked to prove you are the holder. It also opens your customer area: licenses, machines, what the software sends, and remote access to your installation if you allow it. Our team can never read it (see the privacy and transparency page).

The license obtained at first launch, which gives every feature without limits, then automatically becomes a base license (2 controlled inverters). If you had more, the extra controlled inverters and automations are disabled, not deleted (the last ones in the list, outside folders first). The interface and your phone warn you in advance, and you can ask for an extension on the Extend my license page.

Regulation goes on: the software runs at your home. Only the Zendure cloud needs the Internet to pass on setpoints; the built-in MQTT server, the Shelly and Home Assistant work locally. The license is checked once a day, without blocking the regulation during an outage.

The minimum and maximum levels and maximum powers you set for each inverter are always respected. A device that does not respond properly (calibration, setpoint not applied, communication loss) is automatically set aside then retested. Charging powers are capped by your contract. You remain responsible for your electrical installation: when a license is activated, a warning must be accepted (an installation that does not comply with the NF C 15-100 standard can be overloaded).

No measurement. Once a day, the license is validated with ted-energy.fr along with a few anonymous counts (number of inverters and automations, grid type, contracted power) and your inverters' configuration (brand, model, control method, without anything specific to your devices), used to build the list of compatible inverters. With the Zendure cloud, the software talks to Zendure's servers with your account, like the Zendure app. The exact list is published on the privacy and transparency page.

Yes. A new controlled inverter is saved disabled, and TedEnergy offers a validation test when you enable it (Diagnostic › Inverter tests): it drives the inverter at a small power (50 to 200 W), outside regulation, and checks that it responds in both directions. A badge flags inverters never tested or to be re-validated.

Only one HEMS should command an inverter at a time. If TedEnergy sees another system changing an inverter's setpoint or mode, it steps back for 5 minutes (adjustable, 0 to disable), says so clearly on the Inverters page, then takes control again by itself; a “Take control back” button does it sooner. If a written setpoint is never applied by the device, TedEnergy rewrites it three times and then alerts you.

It gives an estimate: the dashboard summary and the PDF reports show in euros the electricity bought from the grid, the surplus sold back, the subscription (per month or per day) and the net bill, using the price of each period of your contract. It is a decision aid, not a bill: it does not replace your supplier's.