Setup Guide
How to connect HedgieMate to your TeslaMate server
Prerequisites
System Requirements
HedgieMate works with your existing TeslaMate installation. For remote access, you'll need:
- Running TeslaMate instance or MyTeslaMate service
- Without remote access, HedgieMate works only on local network
- You can use domain with Cloudflare Zero Trust tunnel access, public IP or VPN solution (Tailscale, OpenVPN, etc.)
TeslaMate API Installation
Install TeslaMate API
HedgieMate requires TeslaMate API to function. This needs to be installed on the same server where TeslaMate is running.
Visit the TeslaMate API GitHub repository for detailed instructions.
Add this service to your existing TeslaMate docker-compose.yml file and update the environment variables to match your current TeslaMate configuration:
... 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:8080Public Access Setup (Optional)
Configure Public Access
Never expose your TeslaMate API publicly without proper authentication. Unauthorized access could compromise your privacy and security.
For remote access to your TeslaMate API, here are some secure options you can consider:
Recommended Solutions
Option 1: VPN Solutions
Option 2: Reverse Proxy with Authentication
Option 3: Cloudflare Zero Trust (requires domain)
Additional Security Tips
- Always use HTTPS/TLS: Never expose your API to public internet over plain HTTP
- Use strong passwords: If using Basic Auth, generate long, random passwords
- Regular updates: Keep your reverse proxy and authentication systems up to date
- Monitor access logs: Regularly check for unauthorized access attempts
- Limit API access: Only expose endpoints you actually need
If you need help setting up secure public access, contact our support team for assistance.
TeslaMate API Installation
Use MyTeslamate Service
MyTeslamate provides a hosted connectivity service for TeslaMate API without requiring local installation. Create a MyTeslamate account if you don't have one yet.
Important: Since the latest MyTeslamate update, authentication is ALWAYS required. Use the tobiasehlert/teslamateapi:latest image and select Basic Auth.
- In MyTeslamate, go to the Add-on section
- Enable Connectivity: TeslaMate API & MQTT and select the
tobiasehlert/teslamateapi:latestimage - For authentication, choose Basic Auth
- Copy the Endpoint URL, Login and Password/Token
- In HedgieMate, paste the Endpoint as your API URL, the MyTeslamate Login as Username and the Password/Token as Password
- Stuck? Email us at [email protected] and we'll help you out.
MyTeslamate Connectivity Guide
Keep your Endpoint URL, Login and Password/Token secure. Never share them publicly – they provide full access to your TeslaMate data.
HedgieMate Configuration
Download HedgieMate
Install HedgieMate from the App Store on your iOS device.
Download on the App StoreConfigure TeslaMate API URL
In HedgieMate, enter your TeslaMate API URL:
- Public access
https://your-domain.com(if using Cloudflare Zero Trust) - IP with port
https://your-ip:8080 - Local network
http://192.168.1.xxx:8080
The URL should point to your TeslaMate API service running on port 8080.
Verify Connection
Test the connection, fetch cars and start exploring your Tesla data with enhanced analytics and insights provided by HedgieMate.