https://github.com/teslamate-org/teslamate
A self-hosted data logger for your Tesla 🚘
https://github.com/teslamate-org/teslamate
elixir-lang grafana home-automation mqtt openstreetmap phoenix-liveview self-hosted srtm tesla tesla-api
Last synced: 3 days ago
JSON representation
A self-hosted data logger for your Tesla 🚘
- Host: GitHub
- URL: https://github.com/teslamate-org/teslamate
- Owner: teslamate-org
- License: mit
- Created: 2019-03-31T20:27:26.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-05-06T07:39:32.000Z (10 days ago)
- Last Synced: 2025-05-06T07:45:28.437Z (10 days ago)
- Topics: elixir-lang, grafana, home-automation, mqtt, openstreetmap, phoenix-liveview, self-hosted, srtm, tesla, tesla-api
- Language: Elixir
- Homepage: https://docs.teslamate.org
- Size: 79.9 MB
- Stars: 6,644
- Watchers: 131
- Forks: 797
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-homelab - TeslaMate - org/teslamate?style=flat)  | A self-hosted data logger for your Tesla 🚘 | (Apps / Tools)
README
# TeslaMate
[](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml)
[](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml)
[](https://coveralls.io/github/teslamate-org/teslamate?branch=main)
[](https://hub.docker.com/r/teslamate/teslamate)
[](https://hub.docker.com/r/teslamate/teslamate)
[](https://hub.docker.com/r/teslamate/teslamate)
A powerful, self-hosted data logger for your Tesla.
- Written in **[Elixir](https://elixir-lang.org/)**
- Data is stored in a **Postgres** database
- Visualization and data analysis with **Grafana**
- Vehicle data is published to a local **MQTT** Broker
## Documentation
The documentation is available at [https://docs.teslamate.org](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
### Dashboards
Sample screenshots of bundled dashboards can be seen by clicking the links below.
- [Battery Health](https://docs.teslamate.org/docs/screenshots/#battery-health)
- [Charge Level](https://docs.teslamate.org/docs/screenshots/#charge-level)
- [Charges (Energy added / used)](https://docs.teslamate.org/docs/screenshots#charges)
- [Charge Details](https://docs.teslamate.org/docs/screenshots#charge-details)
- [Charging Stats](https://docs.teslamate.org/docs/screenshots#charging-stats)
- [Database Information](https://docs.teslamate.org/docs/screenshots/#database-information)
- [Drive Stats](https://docs.teslamate.org/docs/screenshots#drive-stats)
- [Drives (Distance / Energy consumed (net))](https://docs.teslamate.org/docs/screenshots/#drives)
- [Drive Details](https://docs.teslamate.org/docs/screenshots/#drive-details)
- [Efficiency (Consumption (net / gross))](https://docs.teslamate.org/docs/screenshots#efficiency)
- [Locations (addresses)](https://docs.teslamate.org/docs/screenshots/#location-addresses)
- [Mileage](https://docs.teslamate.org/docs/screenshots/#mileage)
- [Overview](https://docs.teslamate.org/docs/screenshots/#overview)
- [Projected Range (battery degradation)](https://docs.teslamate.org/docs/screenshots#projected-range)
- [States (see when your car was online or asleep)](https://docs.teslamate.org/docs/screenshots#states)
- [Statistics](https://docs.teslamate.org/docs/screenshots/#statistics)
- [Timeline](https://docs.teslamate.org/docs/screenshots/#timeline)
- [Trip](https://docs.teslamate.org/docs/screenshots/#trip)
- [Updates (History of installed updates)](https://docs.teslamate.org/docs/screenshots#updates)
- [Vampire Drain](https://docs.teslamate.org/docs/screenshots#vampire-drain)
- [Visited (Lifetime driving map)](https://docs.teslamate.org/docs/screenshots/#visited-lifetime-driving-map)
## Screenshots
Sneak peak into TeslaMate interface and bundled dashboards. See [the docs](https://docs.teslamate.org/docs/screenshots) for additional screenshots.
## Credits
- Initial Author: Adrian Kumpf
- List of Contributors:
- [](https://github.com/teslamate-org/teslamate/graphs/contributors)
- Distributed under MIT License