README

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.

!Web Interface

!Drive Details

!Battery Health

 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:

- Copyl