TED Energy Pilot
Français

Installation guide

Install TED in a few minutes

Three methods depending on your hardware: Synology NAS with a guided script, custom Docker, or directly in Home Assistant OS. Your settings stay at home, on your own machine.

Download the files Next step: getting started

Before you start

  • Home Assistant working and reachable on your local network.
  • Your inverters and batteries visible in Home Assistant, through their brand's integration.
  • A long-lived access token from Home Assistant: Profile › Security › Long-lived access tokens › Create token. Not needed with the Home Assistant OS app.
  • An electricity meter whose measurement (import and export) reaches Home Assistant, or a Shelly read directly by IP.

Synology / NAS Recommended for 24/7

The provided script loads the image, creates the folders and the Docker network, reads your Home Assistant token and starts TED.

  1. 1

    Copy the files to the NAS

    Download ted-bot-v3.2.tar.gz, install_ted_prebuilt.sh and your license, then copy the image and the script to /volume1/docker/ted-bot (for example with File Station).

  2. 2

    Connect over SSH

    On Synology: Control Panel › Terminal & SNMP › enable the SSH service, then connect to the NAS from a terminal.

  3. 3

    Run the installation

    Paste the block below, replacing COLLER_ICI_VOTRE_TOKEN_HA with your token. Adjust the Home Assistant address and the Docker network if needed.

  4. 4

    Open the interface

    Go to http://NAS-IP:5001, import your license in Paramètres (Settings), then follow the getting-started guide.

ARM-based NAS? Download the ARM64 image (ted-bot-v3.2-arm64.tar.gz) and put that file name in IMAGE_ARCHIVE: everything else is identical.

Installation on Synology (SSH) 
cd /volume1/docker/ted-bot
mkdir -p runtime logs
printf "%s\n" "COLLER_ICI_VOTRE_TOKEN_HA" > ha_token.txt

sudo CONTAINER_NAME=ted-bot \
BASE_DIR=/volume1/docker/ted-bot \
HA_TOKEN_FILE=/volume1/docker/ted-bot/ha_token.txt \
NETWORK_NAME=iot-net \
IMAGE_ARCHIVE=./ted-bot-v3.2.tar.gz \
SKIP_PULL=1 \
HA_URL=http://homeassistant:8123 \
INTERACTIVE_PATH_PROMPT=0 \
INTERACTIVE_NETWORK_PROMPT=0 \
INTERACTIVE_HA_TOKEN_PROMPT=0 \
bash install_ted_prebuilt.sh
Check that TED is running 
sudo docker ps --filter name=ted-bot
sudo docker logs --tail 80 ted-bot

Troubleshooting

A problem during installation?

TED's interface does not open

Check the logs with sudo docker logs --tail 80 ted-bot.

The Home Assistant connection test fails

Check that the Home Assistant address can be reached from the machine running TED and that the token is valid and complete. With Docker, the container must be on the same network as Home Assistant (NETWORK_NAME) or use its IP address (HA_HOST_IP).

Port 5001 is already used on my NAS

Add HOST_WEB_PORT=5002 (or another free port) to the installation command, then open the interface on that port.

Where do I import my license?

In TED's interface, Paramètres (Settings) tab. If you lost the file, request it again on the Download page with the same email address.

Still stuck? Ask for help on Discord

TED is running? Move on to getting started.

License, Home Assistant, meter and first inverters: the initial setup explained step by step.

Getting started Ask a question on Discord
Download for free