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:8080) and API token. 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 API token, 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 token
After deploying mytesla/teslamateapi using Docker Compose, find your server IP and exposed port (default 8080). Your API_TOKEN is defined in your docker-compose environment. Example API address: http://192.168.1.100:8080.
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 Token: The token you set in docker-compose
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 your API_TOKEN matches 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サービスに接続
1APIアドレスを設定
TeslaMate APIサービスのアドレスを入力、形式：
2認証方法を選択
内部ネットワーク環境または他の方法で保護されたAPI用
API サービスの環境変数で API_ACCESS_KEY と API_SECRET_KEY を設定します。Secret Key はサーバーから出ません
API_ACCESS_KEY=AKxxxxxxxxxxxxxx
API_SECRET_KEY=SKxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxNginxなどのリバースプロキシでユーザー名/パスワードを設定
3リモートアクセス（オプション）
外部からTeslaMate APIにアクセスする場合：
設定後、「接続テスト」をクリックして確認してください。
よくある問題
APIアドレス、ポート、ファイアウォール設定を確認
認証方法と資格情報を確認
iOSは有効なHTTPS証明書が必要、Let's Encrypt推奨