ha-addon-teslamate

Home Assistant Add-on: TeslaMate

A self-hosted data logger for your Tesla 🚘

About

TeslaMate is a powerful, self-hosted data logger for your Tesla.

• Written in Elixir
• Data is stored in a PostgreSQL database
• Visualization and data analysis with Grafana
• Vehicle data is published to a local MQTT Broker

This add-on allows you to run TeslaMate on your Home Assistant server based on the the official TeslaMate docker image.

This add-on is a fork of the unmaintained add-on at https://github.com/matt-FFFFFF/hassio-addon-teslamate. Thanks to @matt-FFFFFF for maintaining this add-on in the past.

Requirements

TeslaMate v2 needs a PostgreSQL 16.7 or 17.3 or later database. I recommend using the PostgreSQL 17 add-on from @alexbelgium’s repository, or TimescaleDB (for advanced users), if you aren’t already using PostgreSQL.

To get the full experience, it is recommended that you also install the community Grafana add-on and MQTT integration.

Installation

1. Add my add-ons repository to Home Assistant or click the button below to open my add-on repository on your Home Assistant instance.

   

2. Install this add-on.

3. Install the PostgreSQL add-on and configure and start it, if you wish to use this add-on. The database name isn’t important here as the TeslaMate add-on will create the database you name in the settings if it doesn’t exist.

4. Configure Grafana as detailed in this add-on’s documentation.

5. Enter your PostgreSQL configuration information.

6. Enter your Grafana configuration information.

7. Enter your MQTT configuration information.

8. Click the Save button to store your configuration.

9. Start the add-on.

10. Check the logs of the add-on to see if everything went well.

11. Click the OPEN WEB UI button to open TeslaMate.

Upgrading this add-on from v1 to v2

TeslaMate v2 introduced a hard requirement on the version of PostgreSQL database. You will need to use PostgreSQL 16.7 or 17.3 or later. If you are currently using an earlier version of PostgreSQL, you will need to backup your TeslaMate data, upgrade the database, and then restore the data. You can find details on how to do this in the “Migrate TeslaMate to a Different Postres Server” section of this add-on’s documentation tab or in the DOCS.md file in the add-on repository.

Migrating to this version of the add-on

Migrating to this version of the add-on should not result in any loss of data, but you can never be too careful, so I recommend you take a full backup of your Home Assistant instance and also a direct backup of the TeslaMate database as detailed in the TeslaMate documentation before proceeding.

To migrate:

1. Install this version of the TeslaMate add-on as per the details above. Keep your current version installed for now.
2. Open the old add-on configuration options.
3. Click the three dots at the top and select “Edit in YAML”.
4. Highlight and copy all the options.
5. Open this add-on’s configuration options.
6. Click the three dots at the top and select “Edit in YAML”.
7. Replace all content with the configuration copied above.
8. Stop the old add-on.
9. Start the new add-on.
10. Verify everything is working as before and uninstall the old add-on.

Everything should pick up where it was before.