grott-home-assistant-add-on/grott-current/DOCS.md

Grott - Home Assistant native MQTT integration

Installation

1. If you don't have an MQTT broker yet; in Home Assistant go to Settings → Add-ons → Add-on store and install the Mosquitto broker addon.

2. Go back to the Add-on store, click ⋮ → Repositories, fill in
   https://github.com/egguy/grott-home-assistant-add-on and click Add → Close or click the Add repository button below, click Add → Close (You might need to enter the internal IP address of your Home Assistant instance first).

3. The repository includes two add-ons:

   • grott is the stable release that tracks the released versions of grott HA plugin.
   • grott Edge tracks the dev branch of grott HA plugin such that you can install the edge version if there are features or fixes in the grott HA dev branch that are not yet released. (recommended for most users)

4. Click on the addon and press Install and wait till the addon is installed.

5. Click on Configuration

   • If you are not using the Mosquitto broker addon fill in your MQTT details (leave empty when using the Mosquitto broker addon). Format is e.g.:
     

     host: <IP>
     port: 1883
     user: my_user
     password: my_password
     

   • Click Save

   • Tip: it is possible to refer to variables in the Home Assistant secrets.yaml file by using e.g. password: '!secret mqtt_pass'

6. If multiple inverters, please refer on how to configure them on this documentation: https://github.com/johanmeijer/grott/wiki/Multi-Inverter-support

7. Start the addon by going to Info and click Start

8. Configure your data logger using the information contained here: Rerouting Growatt Wifi TCPIP data via your Grott Server

   • Use the local IP of your home assistant
   • Don't use a DNS, the datalogger can't resolve homeassistant.local