TeslaMate is a fantastic free open source project that automatically logs all data from your Tesla. Trips, charging sessions, battery health, energy consumption and much more – presented in beautiful Grafana dashboards. Here is the complete guide to what it is, what it can do, and how to set it up.
What is TeslaMate?
TeslaMate is a self-hosted application that connects to the Tesla API and continuously logs data about your car. Everything is stored locally on your own server – no data is shared with third parties.
It was created by Tesla enthusiasts and is actively maintained by the open source community. The project is completely free.
What can TeslaMate log?
TeslaMate automatically logs:
- Trips – route, distance, consumption, speed
- Charging sessions – location, energy added, duration, battery level start/end
- Battery health – capacity development over time
- Vampire drain – battery loss in standby
- Software updates – when and what was updated
- Map – lifetime driving map of every route you've ever driven
- Efficiency – kWh/100 km by weather and speed
What do you need?
TeslaMate requires:
- Docker and Docker Compose
- A machine that's always on – home server, Raspberry Pi 4, or a cloud VPS
- At least 1 GB of RAM (2 GB recommended)
- About 15-30 minutes for installation
Set it up yourself with Docker
Step 1: Install Docker (Ubuntu):
curl -fsSL https://get.docker.com | sh
Step 2: Create `docker-compose.yml` with content from the official documentation at docs.teslamate.org
Step 3: Replace `ENCRYPTION_KEY` and `DATABASE_PASS` with secure values
Step 4: Start TeslaMate:
docker compose up -d
Step 5: Open `http://your-server-ip:4000` and sign in with your Tesla account. Grafana is on port `3000` (default login admin/admin – change immediately).
Cloud hosting (easiest option)
No home server? A VPS at Hetzner for around €4/month is ideal. Install Docker and follow the guide above. Full control, very affordable.
Security
Never expose port 4000 directly to the internet. Use Tailscale (free) or Cloudflare Tunnel for secure remote access.
Get started today
TeslaMate is free and open source. Official documentation: docs.teslamate.org
Order your Tesla via our referral link and get 1,000 km free Supercharging – and watch TeslaMate log every single kilometre from day one!
Order your Tesla and set up TeslaMate from day one
Use our Tesla link and get 1,000 km free Supercharging – and log every kilometre in TeslaMate.