teslamate

TeslaMate is an open-source, self-hosted data logger purpose-built for Tesla owners who want to keep their vehicle telemetry on their own infrastructure rather than relying on Tesla's cloud. The project is written in Elixir, persists data in a PostgreSQL database, and ships with a set of Grafana dashboards for visualization and analysis. Vehicle data is also published to a local MQTT broker, which makes it straightforward to integrate with Home Assistant, Node-Red, and Telegram. Core capabilities include high-precision drive data recording, automatic address lookup for trip endpoints, geofencing to define custom locations, support for multiple vehicles under a single Tesla account, charge cost tracking, and import of historical data from TeslaFi and tesla-apiscraper. A notable design goal is minimizing vampire drain: the car is allowed to fall asleep as soon as possible after each poll, so the logger does not noticeably shorten range. The web interface also offers a customizable theme mode (light, dark, or system default). The bundled Grafana dashboards cover a wide range of analyses: Battery Health, Charge Level, Charges (energy added/used), Charge Details, Charging Stats, Database Information, Drive Stats, Drives (distance / net energy consumed), Drive Details, Efficiency (net and gross consumption), Locations (addresses), Mileage, Overview, Projected Range (battery degradation), States (online vs. asleep), Statistics, Timeline, Trip, Updates (installed software history), Vampire Drain, and Visited (lifetime driving map). Deployment is container-based, with official Docker images published to Docker Hub and CI/CD workflows for builds and releases. Documentation lives at docs.teslamate.org. The project is licensed under AGPL-3.0, which requires that any modified version distributed or offered as a network service also be released under the same license; a Contributor License Agreement is collected automatically on first pull request to keep the project free software. The README includes a prominent security warning advising users to obtain TeslaMate only from the official repository and documentation, citing reports of deceptive websites and unofficial mobile apps distributing modified or harmful versions that could expose Tesla account credentials and vehicle data.