mirror of
https://github.com/lildude/ha-addon-teslamate.git
synced 2026-10-13 13:10:30 -04:00
Update, refactor and restructure repo (#1)
* Remove unused files * Update dev env * Update config * Update docker config * Add translations * Update run script * Auto-gen enc key if not set * Replace workflows * Replace dependabot with renovate * Remove armhf * Lint * Remove armhf * Whoops * Remove stray comma * Add image * Reorder options * Split and improve docs * Add back image line * Update cw * Typo * Use correct org * Move bootstrap to run * Update scripts * Update config * Add note about database * Label in dockerfile * tmp force devcontainer version * Start implementing db creation if not exists * Create DB if doesn't exist * Update words * Remove unused file
This commit is contained in:
Colin Seymour
@@ -0,0 +1,144 @@
|
||||
# Home Assistant Add-on: TeslaMate
|
||||
|
||||
A self-hosted data logger for your Tesla 🚘
|
||||
|
||||
## About
|
||||
|
||||
[TeslaMate][teslamate] is a powerful, self-hosted data logger for your Tesla.
|
||||
|
||||
- Written in **[Elixir][elixir]**
|
||||
- Data is stored in a **Postgres** database
|
||||
- Visualization and data analysis with **Grafana**
|
||||
- Vehicle data is published to a local **MQTT** Broker
|
||||
|
||||
This addon allows you to run [TeslaMate][teslamate] on your Home Assistant server based on the the official TeslaMate [docker image][docker].
|
||||
|
||||
## Configuration
|
||||
|
||||
The configuration is self-explanatory, but essentially we need details about accessing the PostgreSQL database, Grafana and optionally MQTT.
|
||||
|
||||
### Options
|
||||
|
||||
Remember to restart the add-on when the configuration is changed.
|
||||
|
||||
#### Database Options
|
||||
|
||||
- `database_user`: The username used to connect to your PostgreSQL server.
|
||||
|
||||
- `database_pass`: The password for the user to connect to your PostgreSQL server.
|
||||
|
||||
- `database_port`: The port your PostgreSQL server is listening on. Default: `5432`.
|
||||
|
||||
- `database_host`: The hostname of your PostgreSQL server. Default: `29b65938-postgres` for the [PostgreSQL add-on][postgres].
|
||||
|
||||
- `database_name`: The name of the PostgreSQL database. Default: `teslamate`.
|
||||
|
||||
- `database_ssl`: Use SSL to connect to the database.
|
||||
|
||||
#### MQTT Options (Optional)
|
||||
|
||||
If you are going to use MQTT, you **must** have a username and password defined for your MQTT user; do not use the HA local login (thanks [quach128](https://github.com/quach128)).
|
||||
|
||||
You must also specify an access control list entry for the teslamate user, for example:
|
||||
|
||||
```text
|
||||
user teslamate
|
||||
topic readwrite teslamate/#
|
||||
```
|
||||
|
||||
See the [official docs][mosquitto-docs] on how to configure access control with Mosquitto
|
||||
|
||||
- `disable_mqtt`: Disable MQTT?
|
||||
|
||||
- `mqtt_host`: The hostname of your MQTT server.
|
||||
|
||||
- `mqtt_user`: The username used to connect to your MQTT server.
|
||||
|
||||
- `mqtt_pass`: The password for the user to connect to your PostgreSQL server.
|
||||
|
||||
- `mqtt_tls`: Use TLS to connect to MQTT?
|
||||
|
||||
- `mqtt_tls_accept_invalid_certs`: MQTT TLS Accepts invalid certificates
|
||||
|
||||
- `mqtt_namespace`: MQTT Namespace
|
||||
|
||||
#### Grafana Options
|
||||
|
||||
I recommend you use the existing [Grafana addon][grafana-addon] from the community addons, if you do, please enable the following plugins in your yaml configurations, e.g.
|
||||
|
||||
```yaml
|
||||
plugins:
|
||||
- natel-discrete-panel
|
||||
- natel-plotly-panel
|
||||
- pr0ps-trackmap-panel
|
||||
- grafana-piechart-panel
|
||||
custom_plugins:
|
||||
- name: panodata-map-panel
|
||||
url: https://github.com/panodata/panodata-map-panel/releases/download/0.16.0/panodata-map-panel-0.16.0.zip
|
||||
unsigned: true
|
||||
custom_plugins: []
|
||||
env_vars:
|
||||
- name: GF_SECURITY_ADMIN_USER
|
||||
value: <youruser>
|
||||
- name: GF_SECURITY_ADMIN_PASSWORD
|
||||
value: <yourpass>
|
||||
ssl: true # optional if you are using TLS
|
||||
certfile: fullchain.pem # optional if you are using TLS
|
||||
keyfile: privkey.pem # optional if you are using TLS
|
||||
```
|
||||
|
||||
_Note_ that the security admin password and usernames can only be set on the first start of the Grafana addon, so if you already have it configured you'll need to use the same details or remove the add-on and re-add it.
|
||||
|
||||
- `grafana_import_dashboards`: (Optional, but recommended) Automatically import the grafana dashboards on startup?
|
||||
|
||||
- `grafana_folder_name`: Folder within Grafana to store all the dashboards. Default: `TeslaMate`.
|
||||
|
||||
- `grafana_host`: The hostname of your Grafana server. Default: `a0d7b954-grafana`.
|
||||
|
||||
- `grafana_port`: The port your Grafana server is listening on. Default: `3000`.
|
||||
|
||||
- `grafana_user`: The username used to connect to your Grafana server.
|
||||
|
||||
- `grafana_pass`: The password for the user to connect to your Grafana server.
|
||||
|
||||
- `timezone`: Timezone to use for Granafa dashboards.
|
||||
|
||||
Once you have Grafana up and running, you'll need to configure a data source to read data from the PostgreSQL database:
|
||||
|
||||
![Grafana Postgres data source][grafana-datasource]
|
||||
|
||||
#### Other Options
|
||||
|
||||
- `default_geofence`: (Optional) The default geofence to send via `GEOFENCE` if the car is not in a geofence.
|
||||
|
||||
- `encryption_key`: (Optional) A random string used as encrypt and protect the Tesla API keys. This will be auto-generated on first run if not set.
|
||||
|
||||
- `import_dir`: (Optional) The path to the directory where TeslaMate should look for the TeslaMate export CSV file. Default: `/share/teslamate`.
|
||||
|
||||
## Data Import from TeslaFi
|
||||
|
||||
It is now possible to import CSV data from TeslaFi, refer to the [official docs][teslafi-import].
|
||||
|
||||
Follow this process:
|
||||
|
||||
1. Copy the CSV data to the `/share/teslamate` folder on your Home Assistant instance.
|
||||
You can do this using the [Samba][samba-addon] or [SSH][ssh-addon] addons.
|
||||
|
||||
2. Make sure the `import_path` configuration setting is set to `/share/teslamate`.
|
||||
|
||||
3. Restart the TeslaMate addon and navigate to the web UI, you should be presented with the import screen.
|
||||
|
||||
4. Import the data
|
||||
|
||||
5. Once imported sucessfully, delete the CSV files to avoid the import screen being presented.
|
||||
|
||||
[docker]: https://hub.docker.com/r/teslamate/teslamate
|
||||
[elixir]: https://elixir-lang.org/
|
||||
[grafana-addon]: https://github.com/hassio-addons/addon-grafana
|
||||
[grafana-datasource]: https://raw.githubusercontent.com/lildude/hassio-addon-teslamate/main/media/grafana-postgres.png
|
||||
[mosquitto-docs]: https://github.com/home-assistant/addons/blob/master/mosquitto/DOCS.md
|
||||
[postgres]: https://github.com/matt-FFFFFF/hassio-addon-postgres
|
||||
[samba-addon]: https://github.com/home-assistant/addons/blob/master/samba/DOCS.md
|
||||
[ssh-addon]: https://github.com/home-assistant/addons/blob/master/ssh/DOCS.md
|
||||
[teslafi-import]: https://docs.teslamate.org/docs/import/teslafi
|
||||
[teslamate]: https://github.com/teslamate-org/teslamate/
|
||||
Reference in New Issue
Block a user