Skip to content
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

497 lines (338 sloc) 14.7 KB


1.11.1 - 2019-10-13

Bug Fixes

  • Show all cars in the Overview dashboard

1.11.0 - 2019-10-12

New Features

  • Add overview dashboard (by DBemis; #196)
  • Make :check_origin option configurable via environment variable CHECK_ORIGIN
  • Open GitHub release page when clicking the version tag in the navbar
  • Display the current software version

New MQTT topics

  • teslamate/cars/$car_id/version: Current software version


  • Tweak the mobile and desktop views
  • Add GIST index based on ll_to_earth to speed up geo-fence lookups
  • Improve accuracy of geo-fence lookups for some edge cases
  • Log option codes as well if the vehicle identification fails
  • Delete trips with less than 10m driven
  • Add/Update efficiency factors

Bug Fixes

  • Fix an issue where postgres' automatic analyze couldn't succeed
  • Fix an issue where the derived efficiency factors could not be calculated
  • Exit early if migrations fail
  • Downgrade Grafana to v6.3.5

1.10.0 - 2019-10-05


  • Allow editing of geo-fence positions
  • Show warning icon if the health check fails for a vehicle
  • Use the best available SRTM data source which provides global elevation data including 60N and above
  • Optimize the comparison of geo-fences by moving the lookup into the database
  • Use the exact position instead of the center of an address for the geo-fence lookup
  • Generally improve error handling and error messages
  • Improve landscape mode on devices with a notch
  • Open the geo-fence editor by clicking on the start or destination address of a trip

    Note: For this feature to work Grafana needs to know the base URL of the TeslaMate web interface. To automatically set the base URL open the web interface once after upgrading to this version. Manually changing the base URL is possible via the settings page.

New MQTT topics

  • teslamate/cars/$car_id/healthy: Reports the health status of the logger
  • teslamate/cars/$car_id/windows_open
  • teslamate/cars/$car_id/shift_state
  • teslamate/cars/$car_id/latitude
  • teslamate/cars/$car_id/longitude
  • teslamate/cars/$car_id/odometer
  • teslamate/cars/$car_id/charge_port_door_open
  • teslamate/cars/$car_id/charger_actual_current
  • teslamate/cars/$car_id/charger_phases
  • teslamate/cars/$car_id/charger_power
  • teslamate/cars/$car_id/charger_voltage
  • teslamate/cars/$car_id/time_to_full_charge

Bug Fixes

  • Automatically restart parts of the application if Tesla decides yet again to change the IDs of some vehicles
  • Request to sign in again if the access tokens become invalid e.g. because the password of the Tesla Account has been changed
  • Protect against empty payloads during an update to prevent an update from not being fully logged
  • Log the number of charging phases as returned by the API

⚠️ Running Migrations

Users of the default docker-compose.yml can skip this part.

To run the migrations successfully, the database user has to have superuser rights (temporarily):

  • To add superuser rights: ALTER USER teslamate WITH SUPERUSER;
  • To remove superuser rights: ALTER USER teslamate WITH NOSUPERUSER;

1.9.1 - 2019-09-24


  • Set position when selecting a search entry
  • Fix deletion of geo-fences

1.9.0 - 2019-09-24


  • Show a map with the current vehicle position on the web interface
  • Add a satellite/hybrid layer to the geo-fence map
  • Use elevation data with 1 arc second (~30m) accuracy everywhere not just in the US
  • Add support for MQTT SSL (#140)
  • Add "Charged" annotation to the degradation dashboard
  • Add preferred range setting: you can now choose between "ideal" and "rated" range to use as the basis for efficiency and other metrics


  • Require a data source named "TeslaMate":

    If you don't run the teslamate/grafana docker container the Grafana data source has to have the name "TeslaMate". Prior to this change the default data source was used.

  • Renamed the MQTT topic teslamate/cars/$car_id/battery_range_km to teslamate/cars/$car_id/rated_battery_range_km.


  • Prevent suspending when an update is in progress
  • Fix charge counter when using with multi vehicles (#175)


  • Drop support for the deprecated env variables TESLA_USERNAME and TESLA_PASSWORD

1.8.0 - 2019-09-03


  • Identify cars by VIN: This hopefully eliminates any upcoming problems when Tesla decides yet again to change the IDs of their cars ...
  • Pick geo-fences from a map and show their radius


  • Only add elevation to positions for which SRTM elevation data is available
  • [Security] Bump Grafana version

1.7.0 - 2019-08-29


  • Locally (!) query all locations for elevation data from the NASA Shuttle Radar Topography Mission (SRTM)

  • Add elevation graph to the Drive Details dashboard

  • Display rated range on the web interface and on the Drive Details dashboard

  • Switch to the vehicle_config API endpoint to identify vehicles

  • Display the default and derived efficiency factor on the Efficiency dashboard to detect inaccuracies and to crowdsource the correct factors:

    Note: If there is no default efficiency factor or you think the default factor for your vehicle might be wrong, please open an issue and attach a screenshot of the table showing the efficiency factor(s) for your vehicle.

  • Display charger power on the web interface


  • Fix calculation of charge_energy_added if a previously stopped charge session is resumed

1.6.2 - 2019-08-26


  • Fix migration that could panic when upgrading from v1.4 to v1.6
  • Fix efficiency calculation

1.6.1 - 2019-08-25


  • Add separately configurable sleep requirements


  • Improve identification of performance models
  • Fix Model X identification
  • Improve browser compatibility of the web interface
  • Disable basic auth in Grafana
  • Remove pre-calculated consumption columns and instead calculate consumption values dynamically based on the given efficiency factor
  • Add various database constraints to keep data in a consistent state

1.6.0 - 2019-08-18

Added / Changed


  • Display car name instead of its id and replace dropdown with separate row for each car
  • Improve States dashboard:
    • show state names instead of arbitrary numbers
    • include drives and charge sessions
  • Vampire Drain: include offline state when calculating the standby value
  • Drive Details: add estimated range graph
  • Degradation: Increase resolution of projected 100% range

Web UI

  • Add favicons
  • Fetch last known values from database after (re)starting TeslaMate
  • Show duration of current state
  • Show estimated range
  • Hide stale temperature data
  • Hide some metrics when they're not needed


  • Interpret a significant offline period with SOC gains as a charge session
  • Timeout drive after being offline for too long
  • Dashboards: Dynamically calculate consumption values based on stored car.efficiency

1.5.3 - 2019-08-14


  • Add extra values to the "Time to Try Sleeping" dropdown

  • Rollback the "Time to Try Sleeping" setting to previous pre v1.5 value (21 min) to play it safe

    Note to Model 3 owners and everyone who likes to tweak things a bit: most cars seem to handle a value of 12min just fine. Doing so reduces the likelihood of potential data gaps. Just keep an eye on your car afterwards to see if it still goes into sleep mode.

  • Enable filtering of charges by date

  • Fix charges query to include the very first charge

1.5.2 - 2019-08-13


  • Fix migration that could panic if upgrading from <v1.4.3 to v1.5

1.5.1 - 2019-08-13


  • Remove shift_state condition which could prevent some cars from falling asleep

1.5.0 - 2019-08-12


  • Add geo-fence feature
  • Make units of length and temperature separately configurable
  • Make time to try sleeping and idle time before trying to sleep configurable
  • Show buttons try to sleep and cancel sleep attempt on status screen if possible
  • Add charging stats: charged in total, total number of charges, top charging stations


  • Reduce time to try sleeping from 21 to 12 minutes
  • Increase test coverage
  • Rename some dashboards / panels


  • Add order by clause to degradation query
  • Read LOCALE at runtime


1. New custom grafana image: teslamate/grafana

Starting with this release there is a customized Grafana docker image (teslamate/grafana) that auto provisions the datasource and dashboards which makes upgrading a breeze! I strongly recommend to use it instead of manually re-importing dashboards.

Just replace the grafana service in your docker-compose.yml:

  # ...

    image: teslamate/grafana:latest
      - DATABASE_USER=teslamate
      - DATABASE_PASS=secret
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=db
      - 3000:3000
      - teslamate-grafana-data:/var/lib/grafana

  # ...

And add a new volume at the bottom of the file:

    # ...
    # ...

Find the full example in the updated README.

2. Switch to imperial units


There is a new settings view in the web interface. To use imperial measurements in grafana and on the status screen just tick the checkbox it shows!


With this release API tokens are stored in the database. After starting TeslaMate v1.4 once, you can safely remove both environment variables.

New users need to sign in via the web interface.

Full Changelog:

1.4.3 - 2019-08-05


  • Status screen: show additional charging related information

  • MQTT: add new topics



  • Fix an issue where charging processes were not completed and new charging processes were created after waking up from sleep mode while still plugged in to a charger.

  • Add migration to fix incomplete charging processes

  • Use local time in debug logs:

    Add a TZ variable with your local timezone name to the environment of the teslamate container. Otherwise timestamps use UTC.

  • Charging History: hide entries with 0kWh charge energy added

  • Charging History: include current car-id in links to Charging dashboard

  • Charging History: use slightly earlier start date in links to Charging dashboard to always show the current position

1.4.2 - 2019-08-01


  • Persists tokens after auto refresh

1.4.1 - 2019-07-31


  • Convert to imperial measurements on status screen
  • Fix warnings

1.4.0 - 2019-07-31



  • Introduce custom teslamate/grafana Docker image
  • Fetch unit variables from database


  • Fix syntax errors in consumption and charging dashboard
  • The consumption and charging dashboards can now be viewed without having to select a drive / charging process first.


  • The German dashboard translations have been removed. It was too time consuming to keep everything up to date.



  • Show version on web UI
  • Persist API tokens
  • Add sign in view
  • Add settings view


  • Log :car_id


  • Fix generation of secret_key_base

1.3.0 - 2019-07-29


  • Fix / inverse efficiency calculation: if distance traveled is less than the ideal rated distance the efficiency will now be lower than 100% and vice-versa.

    Important: re-import the Grafana Dashboards (en_efficiency & en_trips) after restarting TeslaMate

1.2.0 - 2019-07-29


  • Add psql conversion helper functions (via database migration)

  • Report imperial metrics

    Important: please re-import the Grafana Dashboards after restarting TeslaMate


  • Remove TZ environment variable from Dockerfile

1.1.1 - 2019-07-27


  • Upgrade tesla_api
  • Upgrade Phoenix LiveView


  • Fix a few english translations in the en dashboards
  • Remove DATABASE_PORT from docker-compose example
  • Remove port mapping from postgres in docker-compose example
  • Extend FAQ

1.1.0 - 2019-07-27


  • Support custom database port through DATABASE_PORT environment variable
  • Add entrypoint to handle db migration


  • Replace node-sass with sass to speed up compilation


  • Update to fix resume and suspend logging PUT requests.

1.0.1 - 2019-07-26


  • Set unique :id to support multiple vehicles
  • Reduce default pool size to 5
  • Install python in the builder stage to build on ARM
  • Increase timeout used on assert_receive calls

1.0.0 - 2019-07-25

You can’t perform that action at this time.