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)
• Web interface in 19 languages (Catalan, Danish, Dutch, English, Finnish, French, German, Hungarian, Italian, Japanese, Korean, Norwegian Bokmål, Simplified Chinese, Spanish, Swedish, Thai, Traditional Chinese, Turkish, Ukrainian); untranslated text falls back to English

Dashboards

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

• Battery Health
• Charge Level
• Charges (Energy added / used)
• Charge Details
• Charging Stats
• Database Information
• Drive Stats
• Drives (Distance / Energy consumed (net))
• Drive Details
• Efficiency (Consumption (net / gross))
• Locations (addresses)
• Mileage
• Overview
• Projected Range (battery degradation)
• States (see when your car was online or asleep)
• Statistics
• Temperatures
• Timeline
• Trip
• Updates (History of installed updates)
• Vampire Drain
• Visited (Lifetime driving map)

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 or later (AGPL-3.0-or-later). See NOTICE for the copyright notice, the additional terms under section 7 of the AGPL, and the trademark notice. For the full legal terms, please refer to the LICENSE file.

This license is designed to ensure that TeslaMate remains free and open for everyone and that improvements made by commercial entities or third parties remain open to the entire community. By using, modifying, or building upon this project, you agree to the following:

• Copyleft: If you modify TeslaMate or incorporate it into another project, you must release the entire source code of your version under the same license (AGPL-3.0-or-later). This applies regardless of how you provide the software to others, in any form, including, without limitation, as a downloadable application, a binary, a package, a pre-packaged image, or a network service (SaaS).
• No Closed-Source Derivatives: We do not permit the use of TeslaMate or its components in closed-source products. Any software made to work with TeslaMate, including, without limitation, apps, dashboards, integrations, and services, must be open-source under an AGPL-compatible license. Software that integrates with TeslaMate may do so only via the supported integration surface (MQTT). If you build upon this project, you are expected to contribute back to the community.
• Attribution: You must keep all original copyright notices, the NOTICE file, and license information intact, and clearly mark modified versions as modified.

Trademark Policy: The use of all trademarks of the TeslaMate project is governed by our Trademark Policy.

Disclaimer: TeslaMate is an independent project and is not affiliated with, endorsed by, or sponsored by Tesla, Inc. "Tesla" and related marks are trademarks of Tesla, Inc.

Contributions: All contributors must sign our Fiduciary License Agreement (FLA 2.0). 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 and allows the teslamate-org to legally defend the project against license violations.

Popularity

Credits

• Initial Author: Adrian Kumpf
• List of Contributors:
•