Documentation · 3.8.1

Getting started with TedEnergy

Install TedEnergy, get your free license, declare your meter and your first inverter, then check that everything works: about 30 minutes.

Documentation up to date with TedEnergy 3.8.1.

What TedEnergy is for

TedEnergy is a multi-brand HEMS (home energy management system) for solar batteries. It continuously decides when your inverters and batteries charge or discharge, based on your electricity meter reading.

The idea: buy less electricity from the grid, store surplus solar power instead of exporting it, and avoid pointless back-and-forth that wears batteries. It works with devices of several brands at the same time.

  • Autonomous mode: TedEnergy manages all your batteries by itself.
  • Assisted mode: TedEnergy completes a manufacturer's HEMS (it keeps control of its own devices, TedEnergy adds yours).
  • It runs at your place, all the time, on a local machine: regulation does not depend on an online TedEnergy service. Only license checks and anonymous statistics go through the Internet (see Privacy).

What you need

  • A machine that stays on: a Home Assistant OS (Raspberry Pi, mini-PC), a Synology NAS, or any computer running Docker (mini-PC, Raspberry Pi 4 or 5, Linux server).
  • Your electricity meter reading, in watts: positive when the house buys from the grid, negative when it exports. A Shelly read directly by its IP address, a Home Assistant sensor, or the value of a device linked to TedEnergy (for example a Zendure Smart Meter).
  • At least one controllable inverter or battery. The up-to-date list of brands and models is on the Compatibility page.
  • A free license, requested by the startup assistant: a first name and an e-mail address are enough.

Home Assistant is not required: a Zendure and a directly read meter (Shelly or linked device) are enough. Home Assistant mostly serves brands without a direct connection.

Choosing your installation

Three methods, from the simplest to the most flexible. Each guide details the steps with screenshots:

  • Home Assistant OS: the simplest. Add the app repository, install, start. No token to create, the connection to Home Assistant is automatic.
  • Synology: Container Manager, no command line.
  • Docker: a single command (or Docker Compose) on any system.

An AI can also guide you step by step on your exact hardware: see installing with an AI assistant.

TedEnergy's interface has no password: never expose it as is on the Internet. To reach it from outside, use a VPN, or the Android app's remote access (which only accepts signed requests).

First launch: the startup assistant

On first opening, an assistant guides you. With Home Assistant OS, open TedEnergy in the sidebar; with Docker or Synology, open the machine's address (for example http://machine-address:5002). Every step can be skipped and resumed later in Settings; the assistant can be relaunched from the Help page.

  1. Free license. First name, e-mail address and consent. A confirmation e-mail may be sent: click the link, TedEnergy carries on by itself.
  2. Connection to Home Assistant (only if you use it, and not with the Home Assistant OS app). The address of Home Assistant with its port (for example http://192.168.1.50:8123) and a long-lived access token: in Home Assistant, click your name at the bottom left, Security tab, Long-lived access tokens, Create token. The “Test the connection” button checks everything.
  3. Meter. Choose your meter reading: Home Assistant entity, Shelly, or the value of a linked device. A three-phase Shelly suggests the right phase after a live test. This step can be skipped: the meter is then declared in Settings › Electricity meter, where several meters can also be ranked by priority (the next one takes over if the first stops answering).
  4. Subscription. Supplier, contract (base, off-peak hours, Tempo…), prices and subscribed power in kVA. This power caps charging power; without it, a new installation charges at 3,000 W at most.
  5. Modes and power. Autonomous and/or Assisted, maximum power and battery levels. The suggested values are fine to start with.
  6. Inverters. The assistant sends you to the page where you declare your devices (next step).

Declaring your first inverter

In Settings › Devices, add a device: choose its brand (one sheet per brand, or “Other brand”) and its model. Each device can have several connections — local API, local MQTT, manufacturer cloud, Home Assistant — and TedEnergy uses the first one available, the next one taking over if it fails.

For a Zendure, the simplest is the cloud: in Settings › Device connectors, paste the Zendure app token then pick the device in the sheet. Only one cloud access is possible per Zendure account: TedEnergy or the Zendure integration of Home Assistant, not both.

Test the sheet before saving it: TedEnergy checks that measurements arrive and commands are accepted.

  • Controlled: TedEnergy sets its charge and discharge.
  • Monitored: TedEnergy only reads it (useful for a device whose commands another system keeps).

Start with a single controlled inverter, watch the result for a few days, then add the others. The Diagnostic › Inverter test page lets you check a device without starting regulation.

Checking that everything works

  • The dashboard shows the animated house: solar, house, grid and batteries, with their live power.
  • In Autonomous mode, the meter stays close to zero when the batteries can absorb or supply what is needed.
  • An idle inverter takes a few seconds to a few tens of seconds to start: this is normal, TedEnergy accounts for it.
  • The minimum and maximum battery levels protect your batteries; adjust them in Settings › Batteries and maximum power.
  • A fault or a setpoint not applied by an inverter is reported on its sheet and in notifications.

During the first days, look at the dashboard balance: energy bought, solar stored, share of the house covered without the grid.

Updates and backup

  • Home Assistant OS: Home Assistant reports the app update; your settings are kept.
  • Synology and Docker: pull the new image and recreate the container with the same data folder (see the guide for your method).
  • TedEnergy itself reports when a new version is available (banner and badge in the top bar).
  • Settings › Backup and versions: export your configuration, restore it, and go back to a previous version if an update causes trouble.

Never delete TedEnergy's data folder during an update: it holds your settings, your license and your history.

Getting help

  • This documentation: one chapter per topic; the PDF version can be downloaded from the documentation home page.
  • The community: Discord and Facebook.
  • An AI: in Settings › Tune with an AI, TedEnergy prepares a text and a summary of your logs to give to ChatGPT, Claude, Gemini or Le Chat. You choose what you share.

Frequently asked questions

Is Home Assistant required?

No. Zendure works through its cloud, or locally through MQTT / local API, without Home Assistant. It mostly serves brands without a direct connection. TedEnergy works as a Home Assistant OS app as well as in Docker.

Is TedEnergy free?

The license is free to start with. Any license limits (number of controlled inverters, duration) are shown in Settings › License and on the Support page.

Can I try it without risk?

Yes. First declare your devices as “monitored” to see what TedEnergy reads, then switch a single one to “controlled”. You can disable an inverter or the whole regulation at any time.

My inverter is not in the list.

Choose “Other brand”: the sheet accepts the entities of any device exposed by Home Assistant or MQTT. If that is not enough, ask on Discord or Facebook: the most requested brands are added first.

What happens if the Internet goes down?

TedEnergy keeps regulating locally. The license is re-checked as soon as the Internet is back, with no blocking in between.

A question, a special case? The community answers on Discord and Facebook. An AI can also analyse your installation: see “Tune with an AI” in TedEnergy's Settings. Discord · Facebook

Ready to make all your batteries work together?

Free download: your free license arrives as soon as your email address is confirmed, no credit card required.

Download for free