TeslaMate iOS App Setup Guide — Mytess Documentation
Get started with Mytess, the best TeslaMate iOS app, in three simple steps. This guide walks you through deploying the API service, connecting the app, and viewing your Tesla data.
Step 1 — Deploy TeslaMateAPI
Deploy the mytesla/teslamateapi service alongside your TeslaMate instance using Docker Compose. If you are starting from scratch, use our one-line install script: curl -fsSL https://mytess.net/scripts/mytess-install.sh | bash. This automatically sets up TeslaMate, the API service, PostgreSQL, Grafana, and Mosquitto MQTT broker. If you already have TeslaMate running, add the teslamateapi service to your existing docker-compose.yml and run docker compose up -d.
Step 2 — Configure the Mytess iOS App
Download Mytess from the App Store. Open the app and go to Settings. Enter your TeslaMateAPI address (e.g. http://your-server-ip:3030) plus API Access Key and API Secret Key. These are the TeslaMateAPI credentials, not TeslaMate's Tesla access/refresh tokens. Tap Test Connection to verify. If your server is behind a Cloudflare Tunnel or reverse proxy, enter the public HTTPS URL. You can also enable Basic Auth or use Cloudflare Service Auth (CF-Access-Client-Id / CF-Access-Client-Secret headers) for extra security.
Step 3 — View Your Tesla Data
Once connected, Mytess displays your Tesla's real-time status, battery health, trip history, charging costs, and statistics. Enable push notifications in Settings to receive alerts for charge complete, parking overtime, and more. A one-time PRO upgrade ($9.9) unlocks all premium features including battery degradation tracking, drive insights, advanced statistics, and Live Activity on the Dynamic Island.
Need Help?
Visit the FAQ page for common issues, or join our Telegram group for community support. You can also email us at hi@mytesla.cc.
TeslaMate API Configuration — Mytess iOS App
This guide explains how to configure the Mytess TeslaMate iOS app to connect to your self-hosted TeslaMate API service. Supported authentication methods include AK/SK, Basic Auth, and Cloudflare Service Auth. Remote access is supported via Cloudflare Tunnel, Tailscale, or any HTTPS reverse proxy.
Step 1 — Obtain your API address and AK/SK credentials
After deploying mytesla/teslamateapi using Docker Compose, find your server IP and exposed port. The Mytess deployment guide commonly maps TeslaMateAPI to port 3030. Your API_ACCESS_KEY and API_SECRET_KEY are defined in your docker-compose environment or printed by the installer. They authenticate Mytess requests to TeslaMateAPI and are not Tesla account access or refresh tokens. Example API address: http://192.168.1.100:3030.
Step 2 — Configure the Mytess iOS app
Open the Mytess app on your iPhone or iPad. Navigate to Settings → API Configuration. Enter:
- API Address: Your TeslaMateAPI URL (HTTP or HTTPS)
- API Access Key and Secret Key: The API_ACCESS_KEY/API_SECRET_KEY pair configured for TeslaMateAPI
Tap Test Connection. A success message confirms the connection is working. Your Tesla data will start loading immediately.
Remote Access via Cloudflare Tunnel
To access TeslaMate outside your local network without port forwarding, use Cloudflare Tunnel. Create a tunnel in the Cloudflare Zero Trust dashboard pointing to your teslamateapi container (port 8080). Enter the public HTTPS tunnel URL in Mytess Settings. For additional security, create a Cloudflare Access Service Token and configure it in the app (CF-Access-Client-Id and CF-Access-Client-Secret).
Remote Access via Tailscale
Install Tailscale on your server and your iPhone. Join the same Tailnet. Use the Tailscale IP address of your server (e.g. http://100.x.x.x:8080) as the API address in Mytess. No port forwarding required. Works securely over any network.
Basic Authentication
If your reverse proxy (Nginx, Caddy, etc.) requires HTTP Basic Auth, enable it in Mytess Settings under Advanced. Enter your username and password. The app appends the Authorization header to all API requests.
Common Issues
- Connection refused: Ensure the teslamateapi container is running (
docker compose ps) and the port is not blocked by a firewall. - 401 Unauthorized: Check that API_ACCESS_KEY and API_SECRET_KEY match what is configured in the app.
- Homepage shows no data: Restart TeslaMate services with
docker compose restartto trigger MQTT data push. - SSL certificate error: Ensure your reverse proxy uses a valid TLS certificate. Self-signed certs are not supported.
API 配置
配置 Mytess 连接到您的 TeslaMate API 服务
1配置 API 地址
输入您部署的 TeslaMate API 服务地址，格式为
2选择认证方式
适用于内网环境或已通过其他方式保护的 API
在 API 服务中设置 API_ACCESS_KEY 和 API_SECRET_KEY，然后在 Mytess 中填写同一组值。它们用于认证 Mytess 对 TeslaMateAPI 的请求。
API_ACCESS_KEY=AKxxxxxxxxxxxxxx
API_SECRET_KEY=SKxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx这组密钥不是 Tesla 账号访问令牌/刷新令牌。TeslaMate 用 Tesla Token 做车辆授权；Mytess 只用 AK/SK 访问你的 TeslaMateAPI 服务。
通过 Nginx 等反向代理配置用户名密码认证
3外网访问（可选）
如果需要从外网访问您的 TeslaMate API，可以考虑以下方案：
配置完成后，点击「测试连接」验证，成功后选择车辆即可开始使用。
常见问题
检查 API 地址、端口、防火墙设置
确认认证方式和凭据是否正确
iOS 要求有效 HTTPS 证书，建议使用 Let's Encrypt