TED Energy Controller
Français

Installation › Home Assistant OS

Guide · Home Assistant OS

Install TED in Home Assistant

A Home Assistant app (formerly add-on): a few clicks, no Docker, no access token. Allow five minutes.

Add the TED repository to Home Assistant

For Home Assistant OS (Green, Yellow, Raspberry Pi, mini-PC, virtual machine): your Settings menu has an Apps section (or “Add-ons”). Otherwise, follow the Synology or command-line guide.

  1. 1

    Add the repository

    Click the button, enter your Home Assistant address if asked, then confirm.

    Add the repository

    Without the button

    Settings › Apps › store button at the bottom right › ⋮ menu › Repositories, paste the address below then Add.

    Repository address 
    https://github.com/LaurentFoulon/ted-home-assistant
  2. 2

    Install the app

    In the store, click TED Energy Controller (reload the page if it does not show), then Install. Allow 1 to 3 minutes.

  3. 3

    Start the app

    Enable Start on boot, Watchdog and Show in sidebar, then click Start.

  4. 4

    Open the interface

    Click TED in the sidebar. The setup wizard guides you: free license, meter, electricity plan… The Home Assistant connection is automatic. The interface is in French for now. Then getting started.

Update

Updating the app

Home Assistant tells you (Settings › Updates): click Update. Your settings, license and history are kept. To forget about it, enable Auto update on the app page.

Your data lives in the app_configs share (formerly addon_configs), …_ted folder: Home Assistant backups include it, except the logs.

Going further

Special cases

Manual installation, without the repository

For a machine without access to GitHub. Updates are then not announced: each version must be dropped in again.

  1. On the download page, choose Home Assistant OS: you get the ted-bot-v3.7-home-assistant.zip package (17 Ko) and a personal command.
  2. Paste that command in the Terminal & SSH app, or copy the package's ted folder into the local_apps share (Samba share app): you must end up with local_apps/ted/config.yaml.
  3. Store › ⋮ › Check for updates, reload the page, then Local apps (Applications locales) › TED Energy Controller › Install. Continue at step 3.
Example (copy yours from the download page) 
D=/addons; [ -d /local_apps ] && D=/local_apps; cd "$D" && curl -fL -o ted.zip "https://ted-energy.fr/download/home-assistant/current?token=YOUR-PERSONAL-LINK" && rm -rf ted && unzip -q ted.zip && rm ted.zip && ls ted
Already using the Docker version? Get your settings back
  1. Stop the old installation (two installations must never control the same inverters).
  2. Install the app above, start it once, then stop it.
  3. Copy the content of the old runtime folder into …_ted/runtime of the app_configs share, replacing the files.
  4. Restart the app: you get your configuration and license back. The old Home Assistant address and token are ignored.
The app does not show in the store

Store › ⋮ › Check for updates, then fully reload the page. Check in ⋮ › Repositories that https://github.com/LaurentFoulon/ted-home-assistant is listed. Errors are in Settings › System › Logs, “Supervisor” log.

The installation fails

Home Assistant must reach the Internet (Docker Hub) and have at least 1 GB free. Details are in the “Supervisor” log; then click Install again.

Getting the license fails

The app must be able to reach ted-energy.fr. Otherwise, download the license from the download page and import it: Paramètres › Sauvegarde, restauration et licence › Importer une licence….

Port 5001 is already in use

App Configuration tab › Network: choose another free port (between 5000 and 5009 for the mobile app), then restart the app. The sidebar does not use this port.

Still stuck? Ask for help on Discord

Installed? Move on to getting started.

The setup wizard, then your first inverters: everything is explained.

Getting started Ask a question on Discord
Download for free