Frequently asked questions
Everything to know before installing TED
Compatibility, installation, license, safety: answers to the questions we hear most. Another question? The community answers on Discord.
General
What exactly is TED?
TED is a HEMS (home energy management system) that runs at home, on your own server (NAS, mini-PC, Linux server) or directly in Home Assistant OS. Connected to Home Assistant, it continuously measures what your home imports from or exports to the grid, then adjusts charging and discharging of all your inverters and batteries so they work together, like one big battery.
Does TED replace my battery's app (manufacturer HEMS)?
Your choice. In assisted mode, your original HEMS (for example the Zendure app) keeps control of its devices and TED adds the power of your other inverters as reinforcement. In autonomous mode, TED regulates the whole installation on its own, independently of manufacturers.
Is TED's interface available in English?
Not yet: TED's interface is currently in French, and your browser's built-in translation works well with it. This website and its guides are in English. An English interface is proposed on the roadmap page: vote for it to raise its priority.
How many inverters and batteries can TED control?
No software limit: add as many controlled or monitored inverters as you need, without a per-device license. The only limit is your electrical installation, which you frame with maximum charge and discharge power.
How can I suggest a new feature?
On the roadmap page: propose your idea or vote for others (interested or not interested) with just your email address, which is never displayed. The most requested ideas rise to the top.
What is a controlled inverter and a monitored inverter?
A controlled inverter receives TED's setpoints (charge and discharge). A monitored inverter is read-only: TED takes its battery and power into account when deciding, without ever sending it a command. This is what makes assisted mode possible next to a manufacturer HEMS.
Compatibility
Which hardware is compatible?
Any inverter or battery that shows up in Home Assistant through its integration (Zendure, Huawei, SMA, Victron, Anker SOLIX, Deye…). Zendure devices are fully tested and validated. The grid measurement comes from your meter, read in Home Assistant or through a Shelly. Details are on the Compatibility page.
Can I mix several battery and inverter brands?
Yes, that is what TED is for: every inverter and battery visible in Home Assistant, whatever its brand, receives one shared setpoint, split according to its capacity and state of charge. See how to run several brands together, and the other problems solved on the Solutions page.
Do I need a Zendure battery or a Shelly meter?
No. The two requirements are Home Assistant and an electricity meter whose measurement (import and export) reaches Home Assistant. Your inverters and batteries simply need to be visible there, through their brand's integration. A Shelly remains a handy option if your meter is not yet connected to Home Assistant.
Is Home Assistant required?
Yes. TED relies on your Home Assistant to read sensors (batteries, power, meter) and to send setpoints to your inverters. With Docker you also need a long-lived access token created in your Home Assistant profile; the Home Assistant OS app does not.
Does TED handle three-phase installations?
TED currently regulates single-phase installations. Three-phase support is on the roadmap page: vote for it if you need it.
My brand is not listed, what can I do?
If your device shows up in Home Assistant, TED can usually use it: give it a try. To ask for deeper support, propose it or vote on the roadmap page, or talk about it on the TED Discord.
Installation
Do I need Docker to use TED?
Not with Home Assistant OS: TED installs as an app on the same machine as Home Assistant (Home Assistant OS guide). Otherwise, TED comes as a Docker image, to install on an always-on local server: Synology NAS, mini-PC or Linux server. To discover it without installing anything, open the live demo. Everything is explained in the installation guide.
Which image should I choose: Intel / AMD or ARM64?
The one matching the processor of the machine that will run TED. Intel / AMD: most Synology NAS, PCs and mini-PCs. ARM64: Raspberry Pi 4 or 5, ARM-based NAS, some routers running virtual machines. If in doubt, the uname -m command prints x86_64 (Intel / AMD) or aarch64 (ARM64). Both images are on the Download page.
Can I install TED directly in Home Assistant OS?
Yes: on Home Assistant OS (Green, Yellow, Raspberry Pi, mini-PC, virtual machine) or Supervised, TED installs as a Home Assistant app (formerly add-on), without Docker or access token, with its interface in the sidebar. Choose Home Assistant OS on the Download page then follow the Home Assistant OS guide. Home Assistant Container and Core cannot run apps: use the Docker installation instead.
How long does installation take?
A few minutes: on a NAS, the provided script prepares the folders and the Docker network and starts the container for you. In Home Assistant OS, allow about fifteen minutes.
How do I update TED?
Come back to the Download page with the same email address: you get your license and the latest version. With Docker, load the new image then restart the container; your settings stay in the runtime folder. With Home Assistant OS, drop the new package as during installation, then click Update in Home Assistant.
License
Is TED free?
TED is free until further notice. Your license is generated as soon as you submit the form and downloads immediately, with no credit card. If you wish, you can support development with a donation, as explained on the Pricing page, with no obligation.
How long is my license valid?
The license downloaded from this site is valid for 30 days. To continue beyond that, get in touch on the TED Discord.
Can I get several licenses?
A license is tied to an email address, which acts as a unique identifier. If you request again with the same email, you get the same license back rather than a new one.
I lost my license file, how do I get it back?
Fill in the form on the Download page again with the same email address: your existing license can be downloaded again, instantly.
Security and data
Is it safe for my batteries?
TED respects the minimum and maximum charge levels and the maximum power you set for each inverter. A device that does not respond correctly (self-calibration, setpoint not applied, lost communication) is automatically set aside, then retested. You remain responsible for your electrical installation: start with cautious limits.
Does my data leave my home?
TED runs on your own machine and talks to your Home Assistant on your local network. No measurement is sent: only the license is validated once a day with the TED server. The exact list of what TED sends over the Internet is published on the privacy and transparency page.
Didn't find your answer? Ask it on the TED Discord: the community and the team will answer.
Ready to make all your batteries work together?
Download TED for free: your license is generated instantly, no credit card required.