Documentation · 3.8.1

Troubleshooting and glossary

Common problems and how to solve them, diagnostic tools, backups and the glossary of words to know.

Documentation up to date with TedEnergy 3.8.1.

Where to start

  • Read the dashboard's status banner and the status line of the inverter concerned: TedEnergy says in plain words what is happening and why.
  • Open the Diagnostic page: links, values received by connection type, inverter start-up times, tests, logs.
  • Look at Notifications and log › Warnings and errors.
  • An AI can analyse your logs: Settings › Tune with an AI.
  • To ask for help, attach the diagnostic package (Diagnostic › Logs: a .zip with the last days' logs and the configuration, tokens and passwords masked).

The interface does not open

  • Check that TedEnergy is running: container started in Container Manager or Docker, app started in Home Assistant.
  • Check the address and port: with Docker, it is the machine's published port (for example 5002); with Home Assistant OS, open TedEnergy in the sidebar.
  • A port already used by another service prevents startup: choose another.
  • After an update, reload the page: a banner offers to.

Home Assistant unreachable or token refused

  • Use Home Assistant's IP address with its port (http://192.168.1.50:8123), not homeassistant.local, which does not always work from a container.
  • A “token refused” comes from an incomplete or deleted token: copy it in full or create a new one.
  • TedEnergy and Home Assistant must be on the same local network.

The meter is not read

  • Check the source in Settings › Electricity meter: entity, Shelly address, or a device's value. The test button shows the measurement.
  • An unreadable meter puts regulation on standby: no setpoint is sent while it is missing.
  • With several meters, the next one takes over after a short delay; the Diagnostic page shows which one is used.
  • Check the sign: positive when the house buys, negative when it exports (inversion setting available).

A battery does not charge or discharge

In order:

  1. Is the inverter enabled and controlled (Inverters page)? A new inverter is saved disabled.
  2. Is the battery level at its minimum (discharge) or maximum (charge)? The restart margin can also hold back a few points.
  3. Is a pause shown (setpoint changed by another system, error 01, calibration)? The sheet says so in plain words.
  4. Does an active mode prevent the action? An automation or a Store feature (holidays, reserve, export limit) can block charging or discharging.
  5. Is the meter read? Without a measurement, nothing is sent.
  6. Do the inverter's measurements arrive? If not, the sheet says “measurements not received”: see the dedicated section.
  7. Run the inverter's validation test (Diagnostic › Inverter test).

Error 01 or 02 that keeps coming back

  • An error 01 flags an inverter that does not apply its setpoint. TedEnergy tests it regularly: usually it unblocks by itself.
  • If it comes back often, check whether the device is calibrating, too cold, or limited by its battery; check its maximum powers in the sheet.
  • A brand with a slow response may need a longer detection delay (Settings › Monitoring and safety).
  • For a device whose behaviour is normal, the Error 01 / 02 inhibition checkbox of its sheet turns detection off.

“Setpoint changed by another system”

TedEnergy saw that an inverter's setpoint or mode was changed outside of it: manufacturer app, Home Assistant integration, third-party automation. The inverter is paused for a few minutes then taken back. To stop this, switch off the other command source; if intended, the pause is adjustable (0 removes it). The Take back control button takes control back immediately.

“Measurements not received”

An inverter's values no longer arrive. For a cloud connection, check that only one access exists for the account (TedEnergy or the manufacturer's integration in Home Assistant), then the connection's Diagnostic page. For a local API or MQTT, check the address, the device's Wi-Fi and that the MQTT server is started. TedEnergy switches by itself to another connection of the device if you declared one.

License impossible to get or validate

  • The machine must be able to reach https://ted-energy.fr.
  • Check your mailbox (junk included): the confirmation link is required.
  • Without Internet access, download the license file from the website and import it (Settings › License).
  • See License and account.

Backup, restore and versions

  • Settings › Backup and versions exports the configuration as a file labelled with the versions that can use it, and restores it after checking. A refused restore explains why (version too old or too recent).
  • TedEnergy can go back to a previous version embedded in the image (Versions page), keeping your settings when possible. A banner reminds you that a previous version is running; if the chosen version does not start, TedEnergy automatically returns to the previous one.
  • Download your configuration before any major change.

Asking for help

The community answers on Discord and Facebook. For effective help, give: TedEnergy's version (Help page), your installation type (Home Assistant OS, Docker, Synology), the brand and model of the inverter concerned, what you expected and what happened, with the time. Support can also connect to your interface if you allow it (see License and account).

Glossary

  • HEMS: home energy management system. It decides when to charge or discharge batteries. TedEnergy is one; many manufacturers supply their own (manufacturer HEMS).
  • Controlled inverter: an inverter that receives TedEnergy's charge and discharge setpoints.
  • Monitored inverter: an inverter run by another system, which TedEnergy measures without commanding; it guides Assisted mode.
  • Draft: a device being set up, never used until enabled.
  • Autonomous mode: TedEnergy manages all batteries by itself by reading the meter.
  • Assisted mode: TedEnergy completes a manufacturer's HEMS (secondary HEMS).
  • SOC (state of charge): a battery's level, as a percentage.
  • Setpoint: the power requested from an inverter.
  • Export / feed-in: electricity sent to the grid (negative meter).
  • Self-sufficiency: the share of the house's consumption that was not bought from the grid.
  • Scheduled charge: charging from the grid during a chosen slot.
  • Surplus charging: charging batteries with surplus solar.
  • Optimised charging: an (experimental) method where two inverters absorb every variation at low power.
  • Cluster: a group of inverters with a shared setpoint. Zone: a group of inverters with a shared power cap.
  • Three-phase (L1, L2, L3): a three-phase grid; each inverter is attached to its phase.
  • Subscribed power: your subscription's power (kVA), which caps charge and discharge.
  • Off-peak / peak hours: tariff periods of your contract. Tempo: a contract with blue, white and red days.
  • Connection: the way to reach a device (local API, MQTT, cloud, Home Assistant).
  • Error 01 / 02: an inverter that does not apply its setpoint / test impossible for now.
  • Store: ready-to-switch-on features. Widget: a dashboard card.

Frequently asked questions

Where do I find TedEnergy's version?

On the interface's Help page (“Software version”), and in Settings › Backup and versions.

TedEnergy restarted, did I lose anything?

No: settings, license and history are in the data folder. Automations resume where they were.

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