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)
- 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 inc