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: 6 months 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 (over 6 years ago)
• Default Branch: main
• Last Pushed: 2025-05-06T07:39:32.000Z (6 months ago)
• Last Synced: 2025-05-06T07:45:28.437Z (6 months 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 🚘 [main maintainer=@JakobLichterfeld] | (Apps / Tools)
• definitive-opensource - TeslaMate - hosted data logger for your Tesla 🚘 [main maintainer=@JakobLichterfeld] | `SelfHost` | **7.2k** | (Table of Contents / Other)

README

          
# TeslaMate

[![CI](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml/badge.svg)](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml)

[![Publish Docker images](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml/badge.svg)](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml)

[![Coverage](https://coveralls.io/repos/github/teslamate-org/teslamate/badge.svg?branch=main)](https://coveralls.io/github/teslamate-org/teslamate?branch=main)

[![current version](https://img.shields.io/docker/v/teslamate/teslamate/latest)](https://hub.docker.com/r/teslamate/teslamate)

[![docker image size](https://img.shields.io/docker/image-size/teslamate/teslamate/latest)](https://hub.docker.com/r/teslamate/teslamate)

[![docker pulls](https://img.shields.io/docker/pulls/teslamate/teslamate?color=%23099cec)](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.

![Web Interface](/website/static/screenshots/web_interface.png)

![Drive Details](/website/static/screenshots/drive.png)

![Battery Health](/website/static/screenshots/battery-health.png)

## Credits

- Initial Author: Adrian Kumpf

- List of Contributors:

- [![TeslaMate Contributors](https://contrib.rocks/image?repo=teslamate-org/teslamate)](https://github.com/teslamate-org/teslamate/graphs/contributors)

- Distributed under MIT License