TeslaMate Addon for Home Assistant

🔔 Note this project is looking for a new maintainer: matt-FFFFFF#124

This addon builds on the excellent work of Adrian Kumpf. See his repo for information regarding the TeslaMate application.

This addon is part of my Home Assistant addon repo - see link for instructions on how to add to Home Assistant.

Installation

1. Add my repository to Home Assistant. See installing third party addons from the Home Assistant documentation.
2. Add the TeslaMate and the PostgreSQL addons from my repo and the Grafana addon from the community repo.
3. Before starting Postgres, configure the addon by setting the DB name, username and password. Now you can start it up.

Tesla API Token Encryption Key

To ensure that the Tesla API tokens are stored securely, an encryption key must be provided via the ENCRYPTION_KEY environment variable. This is set in the addon configuration, using the encryption_key configuration item.

A default has been provided but it is highly recommended to change this!

DB Connection

If using the Postgres addon from my addon repo, the database host is 29b65938-postgres. Below is a snippit from the TeslaMate addon configuration, just replace the DB name, username and password on the Configuration tab of the addon before starting it and you will be good to go.

database_user: username
database_pass: password
database_name: databasename
database_host: 29b65938-postgres
database_ssl: false
database_port: 5432

MQTT Configuration

You must have a username and password defined for your MQTT user, do not use the HA local login (thanks quach128). Below is a sample configuration using the Mosquitto MQTT addon available in the Home Assistant core addon repo:

disable_mqtt: false
mqtt_host: core-mosquitto
mqtt_user: mymqttuser
mqtt_pass: mymqtttpass
mqtt_tls: false
mqtt_tls_accept_invalid_certs: true

Mosquitto access control list

You must specify an access control list entry for the teslamate user, for example:

user teslamate
topic readwrite teslamate/#

See the official docs on how to configure access control with Mosquitto

Grafana Configuration

I recommend you use the existing Grafana addon from the community addons, if you do, please enable the following plugins in your yaml configurations, e.g.

plugins:
  - name: natel-discrete-panel
  - name: natel-plotly-panel
  - name: pr0ps-trackmap-panel
  - name: grafana-piechart-panel
custom_plugins:
  - name: panodata-map-panel
    url: https://github.com/panodata/panodata-map-panel/releases/download/0.16.0/panodata-map-panel-0.16.0.zip
    signed: false
custom_plugins: []
env_vars:
  - name: GF_SECURITY_ADMIN_USER
    value: <youruser>
  - name: GF_SECURITY_ADMIN_PASSWORD
    value: <yourpass>
ssl: true                 # optional if you are using TLS
certfile: fullchain.pem    # optional if you are using TLS
keyfile: privkey.pem       # optional if you are using TLS

Note that the security admin password and usernames can only be set on the first start of the Grafana addon, so if you already have it configured you'll need to remove it and re-add it.

Data Source

Configure a PostgreSQL data source as follows:

Automatically Uploading Grafana Dashboards

Without this step you won't be able to use the TeslaMate dashboards, so this is recommended.

Configure the Grafana addon and set the admin username and password - we will need this to upload the dashboards:

Important! These environment variables are only parsed on the initial set up of Grafana. If you already have the addon configured you'll need to remove it and re-add, setting this configuration for the initial start-up.

env_vars:
  - name: GF_SECURITY_ADMIN_USER
    value: admin
  - name: GF_SECURITY_ADMIN_PASSWORD
    value: mysecretpassword

Now configure the Teslamate addon:

grafana_import_dashboards: true
grafana_folder_name: TeslaMate
grafana_host: a0d7b954-grafana   # this is correct if you use the community addon
grafana_port: 3000               # this is correct if you use the community addon
grafana_user: admin
grafana_pass: mysecretpassword

Data Import from TeslaFi

It is now possible to import CSV data from TeslaFi, refer to the official docs.

Follow this process:

1. Copy the CSV data to the /share/teslamate folder on your Home Assistant instance. You can do this using the Samba or SSH addons.

2. Make sure the import_path configuration setting is set to /share/teslamate.

3. Restart the TeslaMate addon and navigate to the web UI, you should be presented with the import screen.

4. Import the data

5. Once imported sucessfully, delete the CSV files to avoid the import screen being presented.