Installatiehandleiding
Zo verbind je HedgieMate met je TeslaMate-server
Vereisten
Systeemvereisten
HedgieMate werkt met je bestaande TeslaMate-installatie. Voor toegang op afstand heb je nodig:
- Een werkende TeslaMate-installatie of de dienst MyTeslaMate
- Zonder toegang op afstand werkt HedgieMate alleen op je eigen netwerk
- Je kunt een domein met een Cloudflare Zero Trust-tunnel gebruiken, een openbaar IP-adres of een VPN (Tailscale, OpenVPN en dergelijke)
TeslaMate API installeren
TeslaMate API installeren
HedgieMate heeft de TeslaMate API nodig om te werken. Die moet op dezelfde server staan waarop TeslaMate draait.
Uitgebreide instructies vind je op de TeslaMate API op GitHub.
Voeg deze service toe aan je bestaande docker-compose.yml van TeslaMate en pas de omgevingsvariabelen aan zodat ze bij je huidige TeslaMate-configuratie passen:
... existing TeslaMate docker-compose configuration ...
services:
teslamateapi:
image: tobiasehlert/teslamateapi:latest
restart: always
depends_on:
- database
environment:
- ENCRYPTION_KEY=MySuperSecretEncryptionKey
- DATABASE_USER=teslamate
- DATABASE_PASS=secret
- DATABASE_NAME=teslamate
- DATABASE_HOST=database
- MQTT_HOST=mosquitto
- TZ=Europe/Berlin
ports:
- 8080:8080Let op: MQTT_HOST moet naar dezelfde MQTT-broker verwijzen die je TeslaMate gebruikt. Neem de waarde over uit je bestaande TeslaMate Docker-configuratie.
Toegang van buitenaf instellen (optioneel)
Toegang van buitenaf instellen
Stel je TeslaMate API nooit open naar buiten zonder goede authenticatie. Ongewenste toegang kan je privacy en veiligheid in gevaar brengen.
Voor toegang op afstand tot je TeslaMate API kun je een van deze veilige opties overwegen:
Aanbevolen oplossingen
Optie 1: VPN-oplossingen
Optie 2: reverse proxy met authenticatie
Optie 3: Cloudflare Zero Trust (domein vereist)
Extra tips voor de veiligheid
- Gebruik altijd HTTPS/TLS: stel je API nooit open naar het internet over gewoon HTTP
- Gebruik sterke wachtwoorden: kies bij Basic Auth lange, willekeurige wachtwoorden
- Werk regelmatig bij: houd je reverse proxy en authenticatie up-to-date
- Houd de logs in de gaten: controleer regelmatig op ongewenste inlogpogingen
- Beperk de API-toegang: stel alleen de endpoints open die je echt nodig hebt
Kun je hulp gebruiken bij het veilig openstellen van je server? Neem contact op met onze support.
TeslaMate API installeren
De dienst MyTeslamate gebruiken
MyTeslamate biedt een gehoste verbinding met de TeslaMate API, zonder dat je zelf iets hoeft te installeren. Maak een MyTeslamate-account als je die nog niet hebt.
Belangrijk: sinds de laatste update van MyTeslamate is authenticatie ALTIJD verplicht. Gebruik de image tobiasehlert/teslamateapi:latest en kies Basic Auth.
- Ga in MyTeslamate naar het onderdeel Add-on
- Zet Connectivity: TeslaMate API & MQTT aan en kies de image
tobiasehlert/teslamateapi:latest - Kies Basic Auth als authenticatie
- Kopieer de endpoint-URL, de login en het wachtwoord of token
- Plak in HedgieMate het endpoint als API-URL, de MyTeslamate-login als gebruikersnaam en het wachtwoord of token als wachtwoord
- Loop je vast? Mail ons op [email protected] en we helpen je verder.
MyTeslamate-handleiding voor verbindingen
Houd je endpoint-URL, login en wachtwoord of token geheim. Deel ze nooit openbaar, want ze geven volledige toegang tot je TeslaMate-gegevens.
HedgieMate instellen
HedgieMate downloaden
Installeer HedgieMate uit de App Store op je iOS-apparaat.
Download in de App StoreDe TeslaMate API-URL invullen
Vul in HedgieMate je TeslaMate API-URL in:
- Toegang van buitenaf
https://jouw-domein.nl(als je Cloudflare Zero Trust gebruikt) - IP-adres met poort
https://jouw-ip:8080 - Eigen netwerk
http://192.168.1.xxx:8080
De URL moet verwijzen naar je TeslaMate API-service op poort 8080.
De verbinding controleren
Test de verbinding, haal je auto's op en ga je Tesla-gegevens verkennen met de uitgebreide analyses en inzichten van HedgieMate.