teslamate

Mon, 15 Jun 2026 21:26:56 +0800

teslamate-org/teslamate

TeslaMate

A powerful, self-hosted data logger for your Tesla.

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

⚠️ Security Warning

[!CAUTION] Use Official Versions Only

To protect yourself from malicious forks, malware, and data theft, please ensure you only obtain TeslaMate from the official source:

Official Repository: https://github.com/teslamate-org/teslamate
Official Documentation: https://docs.teslamate.org

We have received reports of deceptive websites and unofficial mobile apps (e.g. on the App Store) using the TeslaMate name to distribute modified or harmful versions. If you are using a version from another source, your Tesla account credentials and vehicle data may be at risk.

Documentation

The documentation is available at https://docs.teslamate.org

Features

General

High precision drive data recording
No additional vampire drain: the car will fall asleep as soon as possible
Automatic address lookup
Easy integration into Home Assistant (via MQTT)
Easy integration into Node-Red & Telegram (via MQTT)
Geo-fencing feature to create custom locations
Supports multiple vehicles per Tesla Account
Charge cost tracking
Import from TeslaFi and tesla-apiscraper
Customizable theme mode (light, dark, or system default)

Dashboards

Sample screenshots of bundled dashboards can be seen by clicking the links below.

Screenshots

Sneak peak into TeslaMate interface and bundled dashboards. See the docs for additional screenshots.

License

TeslaMate is licensed under the GNU Affero General Public License v3.0 (AGPLv3).

This license is designed to ensure that TeslaMate remains free and open for everyone. By using, modifying, or building upon this project, you agree to the following:

Reciprocal Sharing (Copyleft): If you modify TeslaMate or incorporate it into another project, you must release the entire source code of your version under the same AGPLv3 license.
Universal Access to Source: This requirement applies regardless of how you provide the software to others—whether you distribute it as a downloadable application (e.g., in an App Store), as a pre-packaged image, or provide access to its functionality via a network service (SaaS).
No Closed-Source Derivatives: We do not permit the use of TeslaMate or its components in closed-source commercial products. If your software interacts with or relies on TeslaMate, it must be open-source. If you build upon this project, you are expected to contribute back to the community.

For the full legal terms, please refer to the LICENSE file.

Key Requirements:

Copyleft: If you modify TeslaMate and distribute it (e.g., as an app, binary, or package) or offer it as a service over a network (SaaS), you must make your modified source code available to all users under the same AGPLv3 license.
No “Closed” Forks: This license ensures that improvements made by commercial entities or third parties remain open to the entire community.
Attribution: You must keep all original copyright notices and license information intact.

Trademark Policy: The use of the TeslaMate name and logo is governed by our Trademark Policy.

Contributions: All contributors must sign our Contributor License Agreement. This is handled via cla-assistant.io automatically on first PR and does not take long. Why do we need this? It guarantees that TeslaMate will always remain Free Software (AGPL-3.0) and allows the teslamate-org to legally defend the project against license violations.

Star History

Credits

Initial Author: Adrian Kumpf
List of Contributors:

Tesla Data Logger on Producthunt daily