Changelog

unreleased

New features

Add navigation active route drive state data (#3657 - @longzheng)

Improvements and bug fixes

ci: prevent workflow runs for certain conditions and allow scheduled runs (f71cc51 and 596a10f - @JakobLichterfeld)
feat: Upgrade web development framework to Phoenix 1.7 (#3615 - @marvelm and @JakobLichterfeld)
ci: stale after 30 days (07670fa -@JakobLichterfeld)
feat: Add stat panel for selected duration in drive details dashboard (#3667 - @oivindoh)
ci: run edge build every night (206d731 - @JakobLichterfeld)
ci: update upload-artifact action (#3689 - @JakobLichterfeld)
fix: upload and merge artifact naming conflict since action version v4 (#3689 - @JakobLichterfeld)
build: bump app base image to fix 'GLIBC_2.34' not found error (#3691- @JakobLichterfeld)
build: bump app dependencies for libssl and netcat to packages available in debian bookworm (#3691- @JakobLichterfeld)
build: reduce the size of the Docker image by cleaning the APT cache (#3692- @JakobLichterfeld)
build(deps): bump dorny/paths-filter from 3.0.0 to 3.0.1 (#3712)

Dashboards

Change tracking line color on Maps to blue (#3670 - @jheredianet)

Translations

Add Thai Translation (#3566 - @tomzt)
Update default.po missing french translations (#3662 - @pquattro)
update zh_Hans text (#3664 - @mrgaolei)
Add missing German translation for new messages, fix mistakes (#3694 - @accolon)
feat: add missing translation for new messages for Korean (#3693 - @zipizigi)
add Traditional Chinese translation for new messages (#3699 and #3709 - @occultsound)
Adding missing Swedish translation for new messages (#3716 -@tobiasehlert)

Documentation

Add details how to configuring the TZ environment variable (#3650 - @NirKli)
doc: add instructions, how to connect to database before editing cars (#3656 - @JakobLichterfeld)
Fix name in lovelace example to match sensor name (#3718 - @js94x)
doc: Hint for null value in Grafana if car has not been renamed yet (#3720 -@js94x)

1.28.3 - 2024-02-02

New features

Support listening on unix domain socket (#3328 - @PhracturedBlue)
Added expected finish charging localtime to teslamate overview in web (#3646 - @NirKli)

Improvements and bug fixes

CI: Remove deprecated probot-no-response and update to stale workflow (#3525 - @JakobLichterfeld)
Fix an issue when car is could enter sleep mode while dog mode is enabled (#3538 - @NirKli)
Handle stream getting the message "Vehicle is offline" and change the state to offline in vehicle (#3508 - @micves)
fix: use product api endpoint to fetch vehicles (#3630 - @brianmay and @JakobLichterfeld)

Dashboards

Update locations.json with car selector (@DrMichael)
Fix Odometer_mi charger dashboard (#3534 - @mechoriet)
Update charges.json: reenable cost per kWh re added (#3544 - @DrMichael)
Improve Battery health derived efficiency estimations and Fix error divided by zero (#3593 - @jheredianet)
Battery Health - Improve performance & adjust queries to handle empty or null data (#3627 - @jheredianet)
charging-stats: map - add charges count and move label (#3625 - @fmossott)

Translations

fix: translation Update default.po for simplified chinese (#3600 - @ycjcl868)
Improvements for Spanish translations (#3610 - @jheredianet)

Documentation

Node-RED required modules should be saved under /data (#3623 - @ToniA)
Use recommended format for Home Assistant MQTT sensor configuration (#3344)
Update projects.md with TeslaBox (#3542 - @mluggy)
update tesla-youq project (#3547 - @brchri)
doc: Fix TPMS sensor names to match binary_sensor.yaml (#3613 - @kenni)
update docker-compose.yml for Docker Compose version v2.24.1 (#3626 - @realJustinLee)

Configure Timezone Setting for Accurate Local Time Display

To ensure time-related features display accurately in your local timezone, configure the TZ environment variable. Detailed instructions are available in our configuration guide.

1.28.2 - 2023-11-27

New features

Improvements and bug fixes

grafana: support DATABASE_SSL_MODE (#3498 - @simonsmh)
Support server_name_indication for ssl (#3497 - @simonsmh)
grafana: Fix Dashboard dropdown link display (#3501 - @oivindoh)
Ci: GHCR Purge success even if package doesn't exist (#3480 - @jlestel and #3504 - @JakobLichterfeld)

Dashboards

Translations

Documentation

1.28.1 - 2023-11-26

New features

Improvements and bug fixes

Fix display version in settings

Dashboards

Translations

Documentation

1.28.0 - 2023-11-26

Note: First release as @teslamate-org organization.

New features

Added tire low pressure icon to teslamate web (#3424 - @NirKli)
Add charging_state to VehicleSummary (#3471 - @brianmay)

Improvements and bug fixes

UI: sync meta theme-color with header background color for iOS status bar (#2840 - @libotony)
Linting in dashboard links (#3443 - @jlestel)
Update Grafana to 10.1.2 (#3455 - @swiffer)
CI: Build PR images on GHCR, so every PR will have a dedicated dockerfile for testing purpose (#3445, #3480, #3481, #3491 -@jlestel)
Update to Node.js 20 (#3477 - @PhilThurston)
Add credo lint support for static code analysis (#3452 - @brianmay)

Dashboards

Fix link to Charge Level dashboard (#3263 - @Sjorsa)
Add LFP variants of Grafana dashboards (#3311 - @eden881)
Average cost stat in stats dashboard (#3030 - @fmossott)
Odometer in Charges dashboard (#3463 - @DrMichael)
Use built-in Grafana visuals instead of plugins (#3439 - @oivindoh and @swiffer)
Ensure that dashboards can be modified after import (#3454 - @swiffer)
Migrate projected range to TimeSeries (#3454 - @swiffer)

Translations

There is nothing new here.

Documentation

Gaussmeter units no longer for sale, #3419 - @LelandSindt
Docker backup restore note about update command when using different TM_DB_USER (#3291 - @tsongalin)
Update FreeBSD installation instructions (#3277 - @uqs)
Updated Docker Compose instructions (#3320 - @Dulanic)
Update HA integration docs with TPMS sensors and examples (#2845 - @marspath)
Fix code style in FreeBSD section (#3461 and #3462 - @ivanovd)
Advise that docker-compose v1 is EOL and to upgrade to v2 (#3472 - @cwanja)
Fix tpms bar sensors name in template for psi (#3490 - @virtualm2000)

1.27.4 - 2023-11-12

Note: TeslaMate moved to the new @teslamate-org organization.

Improvements and Bug Fixes

Add endpoints query param to vehicle_data request to reflect changes to the API (#3398 - @swiffer)
Remove donation links
Fix warnings on Elixir 1.16
Upgrade Grafana to 9.5
Trim whitespace from geofence names
Support self-signed certificates via (DATABASE_SSL_CA_CERT_FILE)
Use preferred tile.openstreetmap.org URL (#3368)
Update dependencies

Dashboards

Charges: Mark end_date as dateTimeAsLocal (#3033 - @DrMichae)
Add Battery Health dashboard (#3059 - @jheredianet)
Show all vehicles on drive stats dashboard (#3342 - @yoyostile)
Updates: Fix for div by zero error (#3289 - @Dulanic)
Show location name in charge details (#3294 - @DrMichael)
Fix broken links when orgId is not 1 (#3380 - @jlestel)
Update query to get car efficiency on Battery Health dashboard (#3245 - @jheredianet)

Translations

Updated Spanish translation (#3244 - @jheredianet)

Documentation

Update docs to use Docker Compose V2 (#3025 - @eden881)
Update FreeBSD instructions (#3394 - @ivanovd)
Add Tesla-YouQ project (#3347 - @brchri)

1.27.3 - 2023-06-12

Improvements and Bug Fixes

Read the vehicle name from the vehicle_data response as Tesla has made some changes to the API
Add composite index to position and drop drive_id index (#3186 - @IlyaDiallo)
Bump Grafana to 8.5.26
Ship Docker image with OTP 26 (this should improve performance on ARM devices)
Optimize automatic Docker image builds

Dashboards

Update drive-details.json missing dataSource for pressure units (#3225 - @OrangeBean)
Bump pr0ps-trackmap-panel to 2.1.4 (#3076 - @Obihoernchen)

Translations

Fix Korean translation (#3126 - @nanishin)

Documentation

Update docs to manually remove vehicle (#3075 - @cwanja)
Update Project: Tesla Home Assistant Integration (#3194 - @Megabytemb)
Updated menu route to Download TeslaFi Data (#3218 - @helmo)

1.27.2 - 2023-01-13

Improvements and Bug Fixes

Bump pr0ps-trackmap-panel to 2.1.3 (fixes #2770)
Bump grafana to 8.5.15
Fix GPX format (#2925 - @martinh2011)
Change esbuild target to es2017
Update Elixir and frontend dependencies
Update GH action workflows

Dashboards

Charging Stats: Update the filter for superchargers (#2832 - @sultantariq)

Translations

Add Ukrainian translations (#3039 - @ZeusF1)
Update Korean translations (#2898 - @zipizigi)
Update Chinese (traditional) translations (#2852 - @occultsound)
Update Chinese translations (#2855 - @JhouXerox)
Update French translations (#2844 - @CrowMash)

Documentation

Fix typo (#2843 - @CrowMash)
Improve FreeBSD installation documentation (#2885 - @victori)
Fix tesla_power unit from W to kW (#3024 - @enzo2)
Added "Custom Grafana Dashboards" to project list (#3056 - @CarlosCuezva)

1.27.1 - 2022-07-22

Improvements and Bug Fixes

Add setting to select tire pressure units
Fix Protocol 'inet_tcp': register/listen error: econnrefused error (#2771 - @manuduarte)
Bump minimum supported Elixir version to 1.12
Improve handling of invalid API tokens

Dashboards

Charging Stats: Include SuC geofences to calculate charging cost

1.27.0 - 2022-07-15

🔓 Encryption of API tokens

To ensure that the Tesla API tokens are stored securely, an encryption key must be provided via the ENCRYPTION_KEY environment variable.

If you use a docker-compose.yml file to run TeslaMate, add a line with the ENCRYPTION_KEY to the environment section or check out the updated installation guiddes on docs.teslamate.org:

services:
  teslamate:
    image: teslamate/teslamate:latest
    environment:
      - ENCRYPTION_KEY=your_secret_encryption_key
      # ...

If no ENCRYPTION_KEY environment variable is provided when running the database migrations a randomly generated key will be set for you to encrypt the tokens. In that case, a warning with further instructions will be displayed.

Improvements and Bug Fixes

Add charge_current_request and charge_current_request_max MQTT topics
Add detection of refresh Model X (2022) (#2455 - @cwanja)
Restart streaming API process if token expired
Do not start erlang's EPMD service
Store vehicle marketing names in the database
Allow customizing the default geofence via the DEFAULT_GEOFENCE environment variable (#2564)
Bump Grafana to 8.5.6

Dashboards

Add datasource to table and map panels (#2391- @andrewjw)
Charge Details: Ensure that battery heater is shown when active during charging (#2527 - @woyteck1)
Charging Stats, Charges: Add average cost per kWh to charging stats (#2693 - @yoyostile)
Charging Stats, Charging Details: Add Charging curve (#2093 - @ToniA, #2152 - @fmossott)
Charging Stats: Add panel with the cost of charges at SuC (#2448 - @carloscuezva)
Charging Stats: Fix for better "Charge deltas" when the charging process is interrupted and re-started (#2566, #2656 - @nicoladefranceschi)
Charging Stats: Set Y-Axis max of heatmap to 100 (#2461 - @DrMichael)
Charging Stats: Update Charging Stats panel styling (#2481 - @cwanja)
Drive Details: Add elevation summary (#2449 - @coreGreenberet)
Drive Details: Record the tire pressure which was made available by Tesla in the 2022.4 SW release (#2706 - @NirKli)
Drive Details: Set elevation units on axis
Drive Stats: Optimize query to estimate mileage calculation (#2464 - @coreGreenberet)
Locations: Let the gauge scale up to the maximum value (#2647 - @DrMichael)
States: Update States top row panels height (#2487 - @cwanja)
Timeline: Fix links (#2601 - @DrMichael)
Trip: Render Trip piechart legend (#2473 - @cwanja)
Migrate dashboards to the new timeseries panels
Change unit of boolean fields

Translations

Update Chinse translation (#2479 - @AemonCao)
Add missing Swedish translation (#2731 - @tobiasehlert)

Documentation

Add ProxyPreserveHost On to the Grafana entries in Apache2 config (#2471 - @DrMichael)
Node-RED: Fix typo (#2410 - @baylanger)
Update to projects page (TeslaMate-ABRP) (#2518 - @fetzu)
Update HomeAssistant Integration examples for HA 2022.6 (#2704 - @star114)
HomeAssistant Integration: enhance km to mi conversion / add timestamp class to charge time (#2735 - @dcod3d)
Add FAQ around Docker timestamp logs (#2655 - @cwanja)
Add HomeAssistant notification example (#2712 - @brombomb)

1.26.1 - 2022-01-28

Improvements and Bug Fixes

Add link on the TeslaMate overview page to the notateslaapp.com release notes (#2390 by cwanja)
Fix token refresh for Chinese accounts

Dashboards

Charges: Show link if the charge cost is not set (#2380 by carloscuezva)
Efficiency: Add min & max values to the Temperature-Efficiency gauge (#2395 by DrMichael)
Overview / Updates: Fix software version format

Translations

Adding missing Swedish translation (#2373 by tobiasehlert)
Small correction for Spanish translation (#2379 by carloscuezva)
Spanish translation refinements (#2388 by jmalcaide)

1.26.0 - 2022-01-25

Improvements and Bug Fixes

Remove support for logins with username/password
Show zoom controls when hovering over or tapping the map (#2184 by bogosj)
Use new Chinese Tesla API endpoints
Fix MFA for Chinese accounts (#2234 by howard0su)
Fix detection of refreshed Model S
Guard against duplicate vehicle API responses
Don't suspend logging while a car software update is downloaded
Don't warn if the update status completing the of a car software update is still reported as 'downloading'
Bump Docker app base image to Debian 11
- Raspberry Pi users unfortunately have to upgrade to Raspbian Bullseye or install the backports version libseccomp2 (see #2302)

Dashboards

Upgrade Grafana to version 8

⚠️ Manually managed Grafana instances have to be upgraded to v8.3.4 or higher!

All table panels have been migrated to the new table component
- This brings a bunch of improvements including an improved experience on small screen sizes
- The date columns now use a local format depending on your browser language setting
The pie chart panels have been migrated to the new native pie charts component
The discrete panels have been replaced by the native state timeline panel

Other

Drive Details: Display if the car is preconditioning (#2281 by carloscuezva)
Timeline: Add filters for destination (#2354 by DrMichael)

Translations

Update Chinese translation (#2232 by howard0su)
Update Chinese translation (#2236 by summergeorge)
Update French translation (#2216 by tydoo)
Update Spanish translation (#2148 by jmalcaide)
Update Italian translation (#2146 by ludovi-com)

Documentation

Update FreeBSD docs (#2226 by rustikles)
Update FAQ: Clarified how the consumption values are calculated and what triggers the recalculations (#2345) by cwanja
Added TeslaMate-ABRP to list of projects (#2314)
Fix typo (#2217 by Oddadin)
Clarify that the pull command needs to be ran from the directory where the docker YML file is located (#2368 by cwanja)

1.25.2 - 2022-01-12

Bump app base image to Debian 11 to fix GLIBC_2.29' not found error
Bump Grafana to 7.5.12

1.25.1 - 2022-01-12

Disable anonymous logins to Grafana by default (when using the teslamate/grafana Docker image)

The first time you visit Grafana, you will be asked to log in. Use the default user admin with the password admin. After successful login, you will be prompted to change the password.
To allow anonymous logins set the environment variable of the Grafana image GF_AUTH_ANONYMOUS_ENABLED to true (use only if your Grafana instance is not exposed to the internet!)

This change only affects users who followed the basic Docker installation guide which, as mentioned in the guide, is intended for home network use only and not for exposure to the internet. Users who followed one of the advanced installation guides are not affected as their Grafana instances always had anonymous logins disabled.

1.25.0 - 2021-11-12

Improvements and Bug Fixes

Add Apple mobile web app capable meta tag (#2128)
Add NOT NULL constraint to the charging_processes.start_date column
Add workaround for an error that occurred when the OS does not return the current date and time
Display marketing names (again). This was necessary due to an API change.
- Add Mid-Range Model 3 (#2057 by RickyRomero)
Show the token sign-up form by default
Sign out if the Tesla API repeatedly returns 401 responses
Use SSO access tokens instead of Owner API tokens (except for Chinese accounts)

Dashboards

Timeline: bugfixes and improvements (#2125, #2092, #2061 by DrMichael)

Translations

Update French translation (#2091 by ranaud80)

Documentation

Add integration Guide for Node-RED, with examples (#2098 by pmboothby)
Update upgrade guide (#2043 by withanhdammit)

1.24.2 - 2021-09-29

Improvements and Bug Fixes

Discard stale data originating from the Tesla Streaming API
Broadcast offline state via MQTT when car goes offline while driving

Dashboards

Updates and Timeline: Link to notateslaapp.com for release notes

1.24.1 - 2021-09-29

Update error message that is shown if reCAPTCHA is required
Update Erlang/OTP version to prevent possible outages due to DST Root CA expiry on Sep 30th

⚠️ NOTE: Tesla have tightened the captcha security once again and now require Google reCAPTCHA to generate API tokens. reCAPTCHA is implemented in a way that makes it impossible to bypass for applications like TeslaMate. There are third-party services that offer to fill these captchas (by having humans solve them manually), but they're slow and can be pricey if you're making a large a mount of requests.

So if you are having issues signing in to your Tesla account via TeslaMate, the only remaining workaround right now is to sign in using existing API tokens (there is a button on the TeslaMate sign-in form). There are multiple apps available to securely generate access tokens yourself, for example:

Auth app for Tesla (iOS)
Tesla Tokens (Android)
Tesla Auth (macOS, Linux)

Users who are already signed in in do not have to worry about it. TeslaMate will continue to be able to access the Tesla API.

1.24.0 - 2021-08-31

Improvements and Bug Fixes

Tesla have once again made changes to the login: TeslaMate can now handle a delayed captcha that first appears after submitting the login form …
Handle Tesla OwnerAPI errors returned by streaming API
Lay the groundwork for the ability to customize the displayed order of vehicles (#1904 by leewillis77)
- The order can currently be customized by manually updating the display_priority column in the cars database table

Dashboards

Charging Stats: Use the full range of colors in the heatmap (#1821 by dyxyl)
Projected Range: Change right y-axis battery level range max from 200% to 100% (#1840 by toneus)
Timeline: Fix for missing drives and add links to the Action column (1818 and #1872 by DrMichael)
Charge Level: Fix diagram glitch (#1936 by DrMichael)

Translations

Add Japanese translation (#1909 by kuma)

Documentation

Add a note about RAM needed after having issues, also a small clarification on where to place the .env file in the advanced guide (#1857 by billerby)
Add note with custom TM_DB_USER when backing up (#1931 by kyleawayan)
Advanced installation with Traefik: Update Grafana rule to limit to TeslaMate host (#1937 by benoitm974)

1.23.7 - 2021-07-16

Improvements and Bug Fixes

Since Tesla have once again made changes to the login with captcha, this version fixes the problems caused by it
Update permissions to the Grafana plugin directory (#1814 by letienne)

Documentation

Fix heading of the Home Assistant binary_sensor config (#1756 by mrzeldaguy)

1.23.6 - 2021-07-08

Improvements and Bug Fixes

Disable sign-in button if captcha code is missing
Fix login for Chinese accounts

1.23.5 - 2021-07-08

Improvements and Bug Fixes

Fix login with captcha

Dashboards

Timeline: Make added kWh more accurate

1.23.4 - 2021-06-18

Improvements and Bug Fixes

Dashboards

Drive Details: Don't round down duration (#1677 by Dulanic)
Projected Range: Prevent division by zero (#1678 by Dulanic)
Updates / States / Stastistics: Use local browser time (#1685 by Ed-M72)
Charge Level: Simplify database query (#1693 by Dulanic)
Timeline: Add new category Missing and some other adjustments (#1708 by DrMichael)
Timeline: Fix missing datasources (#1730 by nickbock)
Bump Grafana to 7.5.8 (Docker image)

Documentation

Fix Home Assistant Lovelace UI and sensors (#1711 by JakobLichterfeld)
Add FreeBSD guide (#1646 and #1712 by tuxbox)

1.23.3 - 2021-06-02

Bug Fixes

Fix API tokens form

1.23.2 - 2021-06-02

Bug Fixes

Fix sign-in for Chinese accounts

1.23.1 - 2021-06-02

Improvements and Bug Fixes

Tesla has removed the captcha again …
Fix error when changing the language to Chinese

Translations

Update Swedish translations (#1655 by tobiasehlert)

1.23.0 - 2021-06-01

Improvements and Bug Fixes

Support Tesla's new captcha verification
Improve naming of addresses (city aliases)
Add power to published MQTT topics (#1504 by mnadvornik)
The Docker image now ships with Erlang/OTP 24 which comes with a JIT-compiler (enabled on most x86 64-bit platforms)
Only publish geofence via MQTT if it has changed
Fix calculation of gross consumption while charging
Fix service mode detection
Fix typo in code_challenge_method (#1571 by tuxbox)
Make dashboards.sh script portable e.g. to BSD (#1645 by tuxbox)

Dashboards

Add a new Timeline dashboard (#1621 by DrMichael)
Statistics: Fix pq: time zone "" not recognized error (#1470 and #1559 by Dulanic)

Translations

Update Swedish translations (#1461 by tobiasehlert)
Update French translations (#1473 by ranaud80)
Update German translations

Documentation

Update Mosquitto version used in docker-compose examples
Add device classes and binary sensors to documented Home Assistant config (#1597 by flacjacket and #1634 by ffeingol)

1.22.0 - 2021-03-17

Improvements and Bug Fixes

Add option to sign in with existing API tokens
Avoid false plugged_in events (#1423 by brianmay)
Handle distinct OSM IDs gracefully when changing the address language
Set another user agent for auth requests.
- ⚠️ This fixes timeouts when signing in for the time being. Most users who are affected reported using a cloud hosting service. Expect this to break anytime Tesla decides to block this type of traffic coming from these providers.
Update user agent used for API requests to GitHub and OpenStreetMap

Dashboards

Add battery heater info to Overview / Charging Details and Charge Details dashboards (#1428 by ToniA)
Statistics: Calculate efficiency from charged energy (#1445 by ToniA)
Make Statistics dashboard look the same on both kilometers and miles (#1439 by ToniA)
Updates: Rename column to "Since Previous Update"

Translations

Update Spanish translation (#1446 by alceasan)

Documentation

Explaining the asleep mode with MCU1 and the non-streaming mode (#1453 by ToniA)

1.21.6 - 2021-03-10

Improvements and Bug Fixes

Change HTTP headers again to avoid auth requests timing out
Fix changing the address language
Add health check route (#1422 by brianmay)

Translations

Update Korean translation (#1381 by dongbum)
Updated Danish translation (#1404 by larskochhansen)

Documentation

Add fixed pricing information to TeslaMateApi project description (#1399 by tobiasehlert)

1.21.5 - 2021-02-21

Improvements and Bug Fixes

Implement a workaround for login requests timing out
Handle failed token refresh requests gracefully

Dashboards

Overview: Fix Gross Panel font size (#1363 by DrMichael)
Charging Stats: Set bucket size on charging heatmap (#1355 by leewillis77)
Downgrade Grafana to 7.3.7 because of an incompatibility with the Trackmap plugin

1.21.4 - 2021-02-16

Enhancements and Bug Fixes

Point out more clearly when starting into import mode
Hide sign-out button in import mode
Don't purge debug log statements from production release
Handle non-existing range values after the car was offline

Dashboards

Statistics: Show "Starting at" column and fix timezone issue (#1254 by DrMichael)
Charge Level: Fix usable battery level alternating between usable battery level and regular battery level
Bump Grafana to v7.4.1

Documentation

Add TeslaMateApi to the list of projects using TeslaMate (#1350 by tobiasehlert)
Update installation docks (#1287 by tobiasehlert)
Update HomeAssistant documentation (#1321 by jschollenberger)

1.21.3 - 2021-02-06

Add support for v3 API tokens in China
Detect if TeslaFi CSV files contain data for more than one car
Change log level for streaming timeouts to debug

1.21.2 - 2021-01-31

⚠️ NOTE: Any previously stored API refresh tokens will no longer function, as Tesla has deprecated the existing authentication endpoint. Existing access tokens will continue to work until they expire. Eventually, a full login will be needed to obtain new refresh tokens.

To immediately obtain new tokens after upgrading, go to the TeslaMate settings page, sign out via the button at the bottom of the page and then sign in again.

Additional:

⚠️ NOTE: This release changes TeslaMate's base Docker image to Debian. If you have any customizations on top of TeslaMate (like healthchecks), they could need updates to work on top of this new image.

Enhancements

Use the new Tesla authentication endpoint for refreshing access tokens
Drop support for the /oauth/token endpoint
Add a sign-out button at the bottom of the settings page

Translations

Add Turkish Language Support (#1194 by neocorp)

Dashboards

Display average outside temperature in charges dashboard (#1213 by DrMichael)

1.21.1 - 2021-01-10

Enhancements

Translations

Add Finnish translation (#1190 by puppee)

Documentation

Add some documentation about updating TeslaMate when installed with Docker (#1170 by fatbasstard)
Update "Import from tesla-apiscraper" documentation: Give an example how to get the vehicle_id from TeslaMate (#1174 by Bdot42)
Add link to unofficial Home Assistant addon (#1188 by matt-FFFFFF)

Other

Allow to use non-standard MQTT ports (via MQTT_PORT)
Refactoring: Use built-in Ecto enum type
Guard against unexpected MFA errors

Bug Fixes

Update drive duration query to avoid displaying different times for drives (Details vs Overview) (#1191 by fatbasstard)
Fix font colors for light theme (Updates dashboard) (#1169 by fatbasstard)
Fix typo (Statistics dashboard) (#1185 by rogiervandergeer)

1.21.0 - 2021-01-02

Enhancements

Dashboards

Drive Details: Add button to download a drive as GPX file (#993 by ayonix)
New dashboard for reporting to Dutch tax (#998 and #1051 by roadrash2108)
Locations: Add panel to see when an address was last visited
Charges/Drives: Add more filtering capabilities (#1016 by Kosta-Github)
Overview: Fix unit of measurement for charge energy added (#1061 by landler)
Charge Level: Add green bars (20/80%) to match "Charge Delta" graph (#1059 by roadrash2108)
Charging-Stats/Trip: Change colors of AC/DC (#1058 by roadrash2108)
Statistics: Resolve issue with month groupings (#1082 by leewillis77)
Updates: Apply number of charges and average rated range to the correct update (#1147 by tlj)

Other

Add support for Tesla’s new authentication process (two-factor authentication)
Optimize TeslaFi CSV file import: reduced memory usage and increased performance
Require Elixir v1.11
Allow to connect to Postgres via IPv6 (via DATABASE_IPV6)
Allow to connect to MQTT broker via IPv6 (via MQTT_IPV6)
Improve detection of whether the vehicle is plugged in during cold weather (+ fix #1154 by virtualm2000)
Use connection pooling for SRTM downloads
Optimize Docker layer caching to speed up image build times
Battery level tooltip: Prevent division by zero error if car is totally down to 0%
Display the actual error if the import directory is not accessible

Translations

Add Italian translation (#1095 and #1096 by HavanaMan)

Documentation

Fix version info on development guide & minor spelling fix (#994 by techgaun)
Update backup_restore.md (#1027 by pihomeserver)
Improve garage door automation example (#1039 by andrewfoster)
Update traefik guide to use a single public hostname instead of two (#1101 by pmboothby)
Projects using TeslaMate:
- TeslaMateAgile: mention Tibber support (#1097 by tobiasehlert)
- Add TeslaMate_Telegram_Bot (#1122 by JakobLichterfeld)
Update installation instructions for Apache (#1124 by juankymoral)

1.20.1 - 2020-10-24

Enhancements

Dashboards

Charge Level: Always show 0% and 100% when state of charge is shown in a diagram (#980 by mbertheau)
Charging Stats: Titles/labels now match pie-charts (#998 by roadrash2108)
Drive Details: Increase width of odometer panel
Efficiency: Set a fixed max value and use LCD gauge
Overview: Fix overlapping timestamps in discrete map (#995 by pmboothby)
Fix overlapping timestamps in trip and states dashboard
Statistics: Add links to other dashboards (#973 by DrMichael)

Translations

Update Norwegian translation (#996 and #1007 by spacecosmos)
Update Swedish translation (#1029 by tobiasehlert)

Other

Display update version in the homescreen update tooltip (#976 by ayonix)
Customize Grafana home screen logo (#1004 by gimmespam)
Bump Grafana to 7.2.1

Bug Fixes

Fix tooltips in car overview being hidden by .card (#975 by ayonix)
Make Statistics dashboard compatible with older versions of Postgres
Open Statistics dashboard with browser time zone when coming from the TeslaMate UI

1.20.0 - 2020-10-04

Enhancements

Dashboards

Update consumption unit to Watt-hour to match in-car unit (#717 by mattw01)
Update dashboards to use the new components from Grafana 7
Charges: Show very short charging sessions
Charges: Add filter for voltage (#857 by Dulanic)
Charging Details: Show kWh even if still charging (#744 by Dulanic)
Charging Stats: Visualize % of sum instead of max kWh in charging heat map (#680 by Dulanic)
Charging Stats: Show cost per 100 km/mi (Charging Stats)
Drives: Update possible values for the "cold" column to be consistent (#702 by Dulanic)
Drive Details: Show drive efficiency
Mileage: Optimize query to get odometer (#804 by Dulanic)
Overview: Add 'total energy added' to chart (#690 by Dulanic)
Overview: Hide stale temperatures
Overview: Show most recent driver temp setting while driving
Overview: Add efficiency (#970 by DrMichael)
States: Display all states names (#755 by DrMichael)
Updates: Add links to release notes (#797 and #823 by pmboothby)
Updates: Show average range and number of chargers per software version to identify if an update had a bigger than expected impact on range (#731 and #762 by Dulanic)
Updates: Fix up the version display when it only has a week value and no point release (#925 by pyjamasam)
Vampire Drain: Utilize charges as additional anchor points (#769 by tacotran)
Add new Statistics dashboard (#965 by DrMichael)
Add the "shared crosshair" setting to some of the dashboards (#932 and #962 by Kosta-Github)
"Customize" Grafana logo (#890 by https://github.com/fatbasstard)

Note

The dashboards require Grafana 7. Make sure you are running the latest version of Grafana if you are not using the Docker installation.

Translations

Update Chinese (Simplified) translation (#747 by edward4hgl)
Update French translation (#693 by tomS3210)
Tweak Dutch translation (#880 and#881 by https://github.com/fatbasstard)

Documentation

Update HomeAssistant documentation (#705 by ngardiner)
TeslaFi Import: Clarify steps 3 and 4 about emptying the import folder (#703 by ramonsmits)
Update Upgrade documentation (#790 by roadrash2108)
Add a page that lists projects that use TeslaMate: docs.teslamate.org/docs/projects
An note about moving the backup file (#813 by traviscollins)
Add -T flag to backup command (#851 by acemtp)

Other

Optimize conversion helper functions
Allow to set a cost by the minute per geo-fence
Allow to set charge cost by minute
Allow negative charge costs
Periodically store vehicle data while charging
Use a more performant HTTP client
Try to keep using API tokens if initial refresh at startup fails
Tweak streaming timeouts and create a new connection after too many disconnects
Change default sleep requirements to not require the car to be locked
Use GitHub Actions to build docker images and publish them to DockerHub
For those who want to help testing the latest development version: the docker images with the edge tag (teslamate/teslamate:edge and teslamate/grafana:edge) are for you.
Allow negative cost_per_unit for geofences (#968 by ayonix)
Speed up parsing of CSV files (data import)

Bug Fixes

Vampire Drain: Fix duplicate values with multiple cars (#726 by Dulanic)
Tooling: Ensure dashboards are restored into the same folder as they currently belong to (#712 by sumnerboy12)
Battery Level & Range: fix wrongly displayed values for multiple cars (#843 by lemmerk)
Fix handling of locations that cannot be geocoded
Show in progress charging sessions
Handle API errors during initialization

1.19.4 - 2020-06-04

Bump Grafana to 6.7.4 which includes an important security patch

1.19.3 - 2020-05-03

Enhancements

Translations

Improve Chinese (Traditional) translation accuracy (#650 by occultsound)
Improve Chinese (Simplified) translation accuracy (#649 by edward4hgl)
Improve Korean translation (#663 by dongbum)

Dashboards

Overview: Update battery gauge thresholds (#651 by wooter)
Drives: Add column header for reduced range (#662 by Dulanic)

Charging Stats: Show map with frequently used chargers (#666 by Dulanic)

Manual install: requires Grafana plugin grafana-map-panel

grafana-cli --pluginUrl https://github.com/panodata/grafana-map-panel/releases/download/0.9.0/grafana-map-panel-0.9.0.zip plugins install grafana-worldmap-panel-ng

Other

Add option HTTP_BINDING_ADDRESS to control the bound IP address (#665 by dyxyl)
Docker image: Pre-install Grafana plugins
Drop unused indexes

Bug Fixes

Fix an issue that could cause a missed firmware update not to be logged retroactively
Fix an issue where the vehicle process could crash when logging was suspended manually
Improve error message for an invalid tokens table
Fix min. distance per drive on Efficiency dashboard to filter correctly in miles (#672 by Dulanic)

1.19.2 - 2020-04-26

Enhancements

Translations

Add Chinese (Simplified) translation (#625 by edward4hgl)
Add Chinese (Traditional) translation (#633 by occultsound)
Fix typo in French translation (#638 by tobiasehlert)
Add Dutch translation (#647 by wooter)

Dashboards

Updates: Show update duration and time since last update (#632 by Dulanic)
Charging Stats: Show kWh at non-decimal level and MWh at the 3 decimal point level (#642 and #646 by Dulanic)

Bug Fixes

Do not publish NULL or incorrect values to MQTT topics if TeslaMate is restarted while the car is asleep

1.19.1 - 2020-04-20

Enhancements

Translations

Add Korean translation (#614 by dongbum)

Bug Fixes

Fix an issue where the map tiles would disappear when editing a geofence
Fix a few things in the docs (#611 by tobiasehlert)

1.19.0 - 2020-04-19

Enhancements

Streaming API

As the first and only Tesla logging app out there, TeslaMate now use the Tesla streaming API! This brings the following improvements:

High precision drive data. Rather than active polling, the streaming API allows for passive consumption of a high frequency data stream with the most important drive data (position, heading, speed, power, elevation etc.).
Actual elevation above sea level. Up until now TeslaMate used satellite terrain data to get the elevation. Driving through tunnels or across a bridges therefore resulted in inaccurate recordings. This is no longer the case!
Bluetooth hints are no longer needed! Using the streaming API does not prevent the vehicle from falling asleep, thus enabling continuous monitoring. This allows the car to fall asleep more quickly (no more idle timer) and we don't miss up to 21 minutes of driving because of halted polling.

Many thanks to everyone who participated in testing this release and contributed improvements!

Translations

Add Danish translation (#584 by MartinNielsen)
Update Norwegian translation (#544 and #591 by spacecosmos)
Update Swedish translation (#522 by tobiasehlert)
Update French translation (#598 by tomS3210 and MaxG88)
Updated Labels to Title Case (#578 by jmiverson)

Other enhancements

Send credentials with manifest request (#555 by MaxG88)
Add option to change the language of the web interface
Reduce docker image size
Display an arrow instead of a generic marker to indicate in which direction the vehicle is heading
Show spinner before the map is initialized
Wait until the doors/trunk/frunk are closed before attempting to fall asleep
Inform if a new TeslaMate update is available
Add icons to navbar items
Add 'About' section to the settings page
Publish only those values via MQTT that have actually changed
Improve detection of available vehicle software updates

New MQTT Topics

teslamate/cars/$car_id/elevation
teslamate/cars/$car_id/trunk_open
teslamate/cars/$car_id/frunk_open

Documentation

The docs were revised (once again). You can find them at docs.teslamate.org.

Add portainer guide to the documentation (#581 by DrMichael)
Improve Apache2 guide (#570 by DrMichael)
Bump traefik to v2.2 (#603 by oittaa)

Bug Fixes

Display vampire drain range loss per hour in the correct units (#543 by ograff).
Trip dashboard: Add title to the drives table to allow sorting (#592 by MaxG88)
Add tini as the init process for the TeslaMate Docker container to avoid zombie processes (#606 by dbussink)
Sort "Drives" table properly by drive date (#595 by Dulanic)
Fix flashing modal on the geofence page
Publish an MQTT message when the health check succeeds again
Handle various invalid API responses that could previously cause problems
Fix an issue where ambiguous dates could cause the TeslaFi import to fail
Terminate an in progress drive when the car is put into service mode

Changed

Increase the minimum Elixir version to 1.10

Removed

Remove sleep mode requirements that are no longer needed
Remove option to disable sleep mode

1.18.2 - 2020-03-28

Bug Fixes

Fix an issue that could cause charging sessions not to be properly recorded if the API reported incomplete charge data
Fix a problem that could cause the TeslaFi import to fail

1.18.1 - 2020-03-23

Bug Fixes

Fix settings dropdown and Swedish translation (#525 by tobiasehlert)

1.18.0 - 2020-03-21

Enhancements

Add Swedish translation (#485 and #522 by tobiasehlert)
Add Norwegian translation (#500 by spacecosmos)
Add Spanish translation (#519 by alceasan)
Overview: Add states panel (#520 by DrMichael)
Immediately display the current car software version after restarting TeslaMate
Add mileage to the summary page
Add option to calculate charging costs retroactively
Allow to enter total cost or cost per KWh used
Indicate if any of the doors are open
Add support for session fees
Store more vehicle config attributes (exterior_color, wheel_type, spoiler_type)
Bump Grafana to 6.7.1

New MQTT Topics

teslamate/cars/$car_id/doors_open
teslamate/cars/$car_id/model
teslamate/cars/$car_id/trim_badging
teslamate/cars/$car_id/exterior_color
teslamate/cars/$car_id/wheel_type
teslamate/cars/$car_id/spoiler_type

Bug Fixes

Drive Stats: Show stats in desired units (#484 by pichalite)
Drive Details: Fix odometer units (#487 by pichalite)
Update address formatting to avoid showing obscure names instead of towns/cities
Charge Details: Hide empty series
Suppress Cldr.NoMatchingLocale warnings
Trip: Prevent 'division by zero' error
Open dashboard links in a new tab to work around Grafana regression
Use the maximum kWh to calculate the charge cost

1.17.1 - 2020-02-23

Bug Fixes

Fix an error that could prevent new users from logging in, among other things
Overview dashboard: Display odometer in desired units

1.17.0 - 2020-02-23

Enhancements

olexs has developed a toolkit to export data from the tesla-apiscraper InfluxDB backend and convert it to a CSV format that can be imported using the TeslaFi Import. Check it out if you want to migrate data to TeslaMate: Import from tesla-apiscraper (BETA)

Simplify geofence editing: The radius can now be changed interactively.
Allow geofences to overlap: If multiple geofences cover a position, the geofence whose centre is closest is selected.
Increase charge cost scale / kWh (#440 by baylanger)
Charge cost view: Show zoom controls
TeslaFi Import: Preselect the timezone
Add configuration option DATABASE_SSL
Use 'rated' as default preferred range
Collapse 'Dashboards' dropdown on mobile

Dashboards

Add Trip dashboard: This dashboard was built to visualize longer trips. It provides an overview of all drives and charges that were logged over a period of several hours or days.
All: Link to the web interface and other dashboards
Overview: Speed up database queries
Charges: Add geofence filter
Charge Details: Add cost overview (#460 by Niek)
Drive Details: Add usable battery level graph

New MQTT Topics

teslamate/cars/$car_id/geofence: The name of the geofence at the current position

Documentation

Add docs for tesla-apiscraper import (#454 by olexs)
Update Backup & Restore docs (#438 by AlwindB)
Revamp manual install docs

Bug Fixes

Fix an issue where some CSV files could not be imported

1.16.0 - 2020-02-07

Enhancements

Import from TeslaFi (BETA)
Calculate charge cost based on location and kWh
Automatically set charge cost to zero if free supercharging is enabled (configurable on the settings page)
Add French translation (#397 by tomS3210)
Improve language detection
Show odometer on 'Drive Details' dashboard
Bump Grafana to 6.6.1
Bump Elixir to 1.10

Documentation

New FAQ entry for adding API tokens directly into the database instead of using username/password (#412 by wishbone1138)
Improve standalone install documentation (#416 by Niek)
Improve iOS Shortcuts guide (#405 by DP19)

Bug Fixes

Re-add charge annotations to the 'Projected Range' dashboard (#393 by ctraber)
Correct typos in projected-range.json (#395 by shagberg)
Increase height of the pie charts panels
Address an issue where a drive would not be properly completed if the vehicle was suddenly reported as asleep after being offline for a while
Fix energy used in 'Drive Details'

1.15.1 - 2020-01-25

Enhancements

Tweak polling intervals
Make the web interface feel snappier

Bug Fixes

Fix an issue where distance, energy used and duration were missing on the Drive Details dashboard if the length unit was set to miles

1.15.0 - 2020-01-23

Enhancements

Add charge cost interface
Display usable SOC and show snowflake icon on summary page (#338 by ctraber)
Log missed software updates
Add tooltip with the estimated range at 100%
Remove software version commit hash
Format remaining charge time
Add option to use a custom namespace for MQTT topics
Periodically store vehicle data while online
Use the Accept-Language HTTP header get the locale (Supported languages: English, German)
Add setting to change the preferred language of OpenStreetMap results
Show spinner while fetching vehicle data
Add dropdown with dashboard links to the navigation bar

New MQTT Topics

teslamate/cars/$car_id/usable_battery_level

Dashboards

Projected Range: Use usable_battery_level to calculate the projected range and add more panels (#338, #367 by ctraber)
Add tesla tag (#369 by TechForze)
Vampire Drain: show SOC difference and ❄ (reduced range)
Charging Stats: Show share of AC/DC charging
Charging Stats: Show top charging stations by cost
Overview dashboard: Use the preferred range
Overview dashboard: Always show latest voltage and power while charging
Add Charge Level dashboard
Add Drive Stats dashboard
Revamp Drives/Drive Details and Charges/Charge Details dashboards

Documentation

Add docs for an advanced Docker install with Apache2 (#361 by DrMichael)
Add docs for backup and restore (#361 by DrMichael)
Update the macrodroid docs (#359 by markusdd)
Add docs for manually fixing data
Add docs for updating Postgres

Bug Fixes

Fix tooltips in Safari (iOS)
Always publish the shift state via MQTT
Fix an issue where he charge location was not be displayed
Fix an issue that could cause the added charge kWh to be shown as 0

⚠️ Please note: Due to internal changes, all addresses will be recalculated on first startup. Depending on the amount of data, this process may take up to 30 minutes or longer.

1.14.3 - 2020-01-06

Enhancements

Locations dashboard: Visualize cities and states with the most stored addresses

Bug Fixes

Fix an issue where a broken rear window sensor could cause the windows to always be displayed as open
Address an issue where a charge wouldn't be properly logged if the Tesla API reported invalid charge data
Fix a bug that could cause the geo-fence form to become unresponsive

1.14.2 - 2020-01-03

Bug Fixes

Fix an issue where invalid or revoked tokens could cause the application to crash after startup
Change default time range in the 'Updates' dashboard

1.14.1 - 2019-12-24

Bug Fixes

Fix an issue where the database migrations would not succeed if there were charges without any data points

1.14.0 - 2019-12-22

Enhancements

Documentation

@gundalow has revamped the docs (#292, #314). The new documentation is available here: teslamate.readthedocs.io

Automatic phase correction

The phase correction is now applied automatically.

Background: some vehicles incorrectly report 2 instead of 1 or 3 phases when charging. This led to an incorrect calculation of the 'kWh used'. Furthermore, the calculation did not work reliably in three-phase networks with e.g. 127/220V. Therefore it was necessary in the past to manually activate a phase correction for specific geo-fences. With this update the correction is now applied automatically.

Other enhancements

Refactored API module
Increased polling frequency in asleep state
New OSM aliases
... and other minor improvements

Bug Fixes

Efficiency Dashboard: convert km/h to mph in the temperature efficiency table
Fix an issue where the application could crash because the database pool was too small
Fix an issue where a drive/charge could be split into two parts due to API timeouts

1.13.2 - 2019-12-07

Enhancements

Enable the time range control in the "Charging Stats" dashboard (#278 by @nnoally)
Various docs improvements (#285 by @gundalow)

Bug Fixes

Fix issue where on a brand new installation suspending logging would only work after a restart
Fix the elevation scale in the Drive Details

1.13.1 - 2019-11-26

Enhancements

Add a database column that will allow tracking charge costs:

Merge 20191117042320_add_cost_field_to_charges.exs (Charge Cost field) (#258 by @ngardiner)
Grafana Dashboard Integration for Charge Cost (#273 by @ngardiner)

Note: There is no charging cost interface either manual or automatic at this point but there will be in the future.

Bug Fixes

Downgrade the Grafana docker image to v6.3.7 because there are still issues with ARM-compatible images
Fix an issue where the selected car was not displayed when opening the drive or charging details

1.13.0 - 2019-11-25

New Features

Display link "Dashboards" inside the navigation bar (it becomes visible after clicking an address in one of the Grafana dashboards. Alternatively the Grafana URL can be added manually on the settings page)
Enable or disable the sleep mode depending on the location. For example, the car can be allowed to sleep at home or work, but nowhere else.
Extend Charge Stats Dashboard with discharge stats, a charge delta graph and a charge heatmap (#270 by @marcogabriel)

Enhancements

Make sleep mode separately configurable for each car
Reduce default "Time to try sleeping" to 12 minutes for newer vehicles
The "States" dashboard now includes software updates
Automatically repair trips and charges with missing addresses (e.g. because OpenStreetMap was temporarily unavailable)
Update thresholds of the battery level gauge (#256 by @marcogabriel)

Bug Fixes

Fix issue where consumption values were displayed as 0
Fix issue where installing a software update when charging would produce an incomplete charge record

1.12.2 - 2019-11-06

Bug Fixes

Fix an issue where the "states" graph would not show every drive/charge
Fix an issue where the application would not start if the vehicle was parked at a place with poor reception
Remove duplicate table row "Remaining Time"

1.12.1 - 2019-11-03

Enhancements

Display remaining time while charging

New MQTT Topics

teslamate/cars/$car_id/heading

Bug Fixes

Consistent language for label of charging events (#299)
Cap charging efficiency to 100%

1.12.0 - 2019-10-28

We finally have documentation! Many thanks to @ngardiner, who gave the impulse and did most of the work and also to @krezac, who contributed a guide to creating iOS Shortcuts for TeslaMate!

New Features

Vehicle Efficiency

Previous versions of TeslaMate shipped with hard-coded efficiency values for the various Tesla models. These efficiency values are needed to calculate trip consumptions, because the Tesla API does not provide them directly.

The hard-coded values were probably pretty accurate, but it was impossible to ensure the correctness of all of them. In addition, the new Model S and X "Raven" could not be reliably identified because the Tesla API returns wrong option codes for both.

This version eliminates the need to use these hard-coded values and instead calculates them based on the recorded charging data. It takes at least two charges to display the first estimate. Each subsequent charge will then continue to improve the accuracy of the estimate, which is applied retroactively to all data.

Charge energy used

In addition to the kWh added to the battery during the charge TeslaMate now calculates the actual energy used by the charger, which in most cases is higher than the energy added to the battery.

Consider this feature somewhat experimental. Theoretically, however, it should be pretty accurate as long as the vehicle has a stable internet connection while charging (other paid Tesla loggers use the same calculation method).

Currently, a firmware bug in some vehicles may cause the wrong number of phases to be reported when charging at some chargers. As a workaround, a phase correction can be activated per geo-fence.

New MQTT Topics

teslamate/cars/$car_id/update_available
teslamate/cars/$car_id/is_climate_on
teslamate/cars/$car_id/is_preconditioning
teslamate/cars/$car_id/is_user_present

Enhancements

Show icon indicators for various states (sentry mode, vehicle locked, windows open, pre-conditioning etc.)
Various UI Tweaks
Grafana: show the precise duration of a trip in a tooltip
Serve gzipped assets
Disable origin check by default to simplify the installation of TeslaMate. (⚠️ For publicly exposed TeslaMate instances it is advisable to re-enable the check by adding the environment variable CHECK_ORIGIN=true.)

Bug Fixes

Set the correct end date for charges where the vehicle remains plugged in after completion
Fix an issue with vehicles that were removed from the Tesla Account
Correctly handle API responses which indicate that the vehicle is in service
Display effects of range gains (e.g. from supercharging pre-conditioning a cold battery) as NULL

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

Enhancements

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

Enhancements

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

Fixed

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

1.9.0 - 2019-09-24

Added

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

Changed

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.

Fixed

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

Removed

Drop support for the deprecated env variables TESLA_USERNAME and TESLA_PASSWORD

1.8.0 - 2019-09-03

Added

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

Fixed

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

1.7.0 - 2019-08-29

Added

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

Fixed

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

1.6.2 - 2019-08-26

Fixed

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

1.6.1 - 2019-08-25

Added

Add separately configurable sleep requirements

Fixed

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

Dashboards

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

Fixed

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

Fixed

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 12 min 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

Fixed

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

1.5.1 - 2019-08-13

Fixed

Remove shift_state condition which could prevent some cars from falling asleep

1.5.0 - 2019-08-12

Added

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

Changed

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

Fixed

Add order by clause to degradation query
Read LOCALE at runtime

1.4

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:

  # ...

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

  # ...

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

volumes:
    # ...
    teslamate-grafana-data:
    # ...

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!

3. Deprecation of TESLA_USERNAME and TESLA_PASSWORD

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

Added

Status screen: show additional charging related information

MQTT: add new topics

teslamate/cars/$car_id/plugged_in
teslamate/cars/$car_id/scheduled_charging_start_time
teslamate/cars/$car_id/charge_limit_soc

Fixed

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

Fixed

Persists tokens after auto refresh

1.4.1 - 2019-07-31

Fixed

Convert to imperial measurements on status screen
Fix warnings

1.4.0 - 2019-07-31

Dashboards

Added

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

Fixed

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.

Removed

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

TeslaMate

Added

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

Changed

Log :car_id

Fixed

Fix generation of secret_key_base

1.3.0 - 2019-07-29

Changed

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

Added

Add psql conversion helper functions (via database migration)
Report imperial metrics

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

Fixed

Remove TZ environment variable from Dockerfile

1.1.1 - 2019-07-27

Changed

Upgrade tesla_api
Upgrade Phoenix LiveView

Fixed

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

Added

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

Changed

Replace node-sass with sass to speed up compilation

Fixed

Update README.md to fix resume and suspend logging PUT requests.

1.0.1 - 2019-07-26

Changed

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly