How to set up TeslaMate with Docker?

TeslaMate is designed for Docker deployment; the official documentation provides a docker-compose.yml file that sets up PostgreSQL, Grafana, and MQTT in one go, but it requires basic command-line skills.

TeslaMate vs TeslaFi: which is better?

TeslaMate is free and self-hosted for full data control, while TeslaFi is a paid cloud service with mobile apps and less setup. Choose TeslaMate for privacy, TeslaFi for convenience.

Does TeslaMate work with all Tesla models?

Yes, it supports all Tesla vehicles, including Model S, 3, X, and Y, by logging data via the Tesla API, as implied by its multi-vehicle feature.

How to import my old TeslaFi data into TeslaMate?

TeslaMate has a built-in import tool; you need to export your data from TeslaFi and follow the documentation to load it into the local PostgreSQL database.

Can I use TeslaMate without running Grafana?

Grafana is essential for the pre-built dashboards; while you can query raw data from PostgreSQL, visualization and most features depend on Grafana integration.

Is TeslaMate safe from hackers?

Security is your responsibility since it's self-hosted; the README warns against unofficial versions, and you must implement measures like HTTPS and strong passwords as per the docs.

TeslaMate

AGPL-3.0Elixirv3.0.0Self-Hosted

A self-hosted data logger for Tesla vehicles that records high-precision driving data and visualizes it with Grafana.

Visit Website GitHub

7.9k stars926 forks0 contributors

What is TeslaMate?

TeslaMate is a self-hosted data logging and visualization platform for Tesla vehicles. It continuously collects telemetry data—such as driving behavior, charging sessions, battery health, and location history—and stores it in a local PostgreSQL database. The platform provides comprehensive Grafana dashboards to analyze vehicle performance, efficiency, and long-term trends, giving owners full control over their data.

Target Audience

Tesla owners who want to monitor their vehicle's performance, track battery degradation, analyze driving efficiency, and integrate vehicle data into home automation systems like Home Assistant.

Value Proposition

Unlike cloud-based services, TeslaMate is entirely self-hosted, ensuring data privacy and ownership. It offers high-precision logging, optimized sleep management to prevent vampire drain, and seamless integration with popular home automation tools via MQTT.

Overview

A self-hosted data logger for your Tesla 🚘 [main maintainer=@JakobLichterfeld]

Use Cases

Best For

Tracking Tesla battery health and degradation over time

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Analyzing driving efficiency and energy consumption patterns

Monitoring charging costs and session history

Integrating Tesla data into Home Assistant for smart home automation

Visualizing lifetime driving maps and trip history

Importing and consolidating historical data from TeslaFi

Not Ideal For

Users who want a cloud-hosted, zero-maintenance service with native mobile apps
Tesla owners only interested in real-time vehicle status without historical analytics
Commercial projects or companies needing to integrate vehicle data into closed-source products due to AGPL licensing restrictions
Environments without a dedicated, always-on server for continuous data logging

Pros & Cons

Pros

Full Data Ownership

As a self-hosted platform, TeslaMate ensures all vehicle data remains on your own infrastructure, aligning with its philosophy of privacy and control over third-party cloud services.

Comprehensive Grafana Dashboards

Includes pre-built dashboards for battery health, efficiency, charging analytics, and lifetime driving maps, providing rich visualization without additional setup.

Seamless Smart Home Integration

Publishes data to MQTT, enabling easy connections with Home Assistant, Node-RED, and Telegram for automation, as highlighted in the features list.

Optimized Vampire Drain Prevention

Minimizes battery drain by allowing the car to sleep quickly, a key feature mentioned to reduce energy loss when parked.

Cons

Complex Multi-Service Setup

Requires deploying and maintaining PostgreSQL, Grafana, and MQTT brokers, which can be daunting for users unfamiliar with Docker or server administration.

AGPL Licensing Limitations

The copyleft license forces any modifications or network services using TeslaMate to be open-sourced, potentially hindering commercial or proprietary integrations.

No Official Mobile Interface

Relies on web-based Grafana dashboards and third-party apps via MQTT, lacking a dedicated mobile app for convenient on-the-go access.

Open Source Alternative To

TeslaMate is an open-source alternative to the following products:

T

TeslaFi

A third-party web service for Tesla vehicle owners that provides detailed analytics, trip logging, and data visualization from their vehicle's telemetry.

Frequently Asked Questions

Home

Self Hosted

CyberChef

The Cyber Swiss Army Knife - a web app for encryption, encoding, compression and data analysis

Stars34,641

Forks3,916

Last commit4 days ago

ConvertX

💾 Self-hosted online file converter. Supports 1000+ formats ⚙️

Stars16,604

Forks909

Last commit2 days ago

google-webfonts-helper

A Hassle-Free Way to Self-Host Google Fonts. Get eot, ttf, svg, woff and woff2 files + CSS snippets

Stars12,940

Forks445

Last commit1 month ago

iSponsorBlockTV

SponsorBlock client for all YouTube TV clients.

Stars5,408

Forks233

Last commit5 days ago