Mytess is a TeslaMate iOS app built for Tesla owners who use TeslaMate. It connects to your TeslaMate API and provides a beautiful data visualization interface to view your Tesla's status, trips, charging info, and statistics anywhere. It's the best TeslaMate iOS client available.

What do I need to use Mytess TeslaMate iOS app?

You need: 1) An iPhone or iPad running iOS 18.0 or later; 2) A running TeslaMate instance; 3) The mytesla TeslaMate API service deployed. If you don't have TeslaMate yet, check our deployment guide on the website.

Does Mytess collect my Tesla vehicle data?

No. Mytess does not store any vehicle data on our servers. All Tesla data is fetched directly from your own TeslaMate API server, not through any third-party servers. Your privacy and data security are our top priority.

Is there a TeslaMate app for iPhone?

Yes! Mytess is the best TeslaMate iOS app available for iPhone and iPad. It provides a beautiful native iOS interface to view and analyze your TeslaMate data, including battery health, charging costs, trip history, and real-time notifications.

How can I track my Tesla battery degradation?

With Mytess and TeslaMate, you can track your Tesla's battery health and degradation over time. The app visualizes your battery capacity changes, charging cycles, and provides insights into your battery's condition.

How much does Mytess cost?

Mytess offers a one-time payment of $9.9 USD for lifetime access to all features. The free version includes core features like real-time status, battery health, trip records, and charging history.

What is mytesla/teslamateapi?

mytesla/teslamateapi is the API service that bridges your TeslaMate data with the Mytess app. It is based on tobiasehlert/teslamateapi (thanks to the original author) and is supported by the official myteslamate connect feature. It only reads data from your database and MQTT service, and will never modify any existing TeslaMate data structures. If notifications are enabled, it communicates with Apple APNs without transmitting any unique vehicle identifiers, ensuring your data privacy and security.

How to upgrade mytesla/teslamateapi?

To upgrade TeslaMateAPI to the latest version, run: curl -fsSL https://mytess.net/scripts/mytess-tool.sh | bash -s -- upgrade-api. Or manually: docker compose pull teslamateapi && docker compose up -d teslamateapi. The upgrade only pulls and restarts the teslamateapi service — your TeslaMate, database, and MQTT services will not be affected.

How to backup TeslaMate data?

It is strongly recommended to backup your TeslaMate database regularly. Run: curl -fsSL https://mytess.net/scripts/mytess-tool.sh | bash -s -- backup. Or manually: docker compose exec -T database pg_dump -U teslamate teslamate > teslamate_backup.bck. Store the backup file in a safe location (external drive, cloud storage, etc.).

How to restore TeslaMate data?

To restore from a backup file: 1) Stop TeslaMate to prevent write conflicts, 2) Drop and recreate the database schema with required extensions, 3) Restore data from the backup file, 4) Restart TeslaMate. Run: curl -fsSL https://mytess.net/scripts/mytess-tool.sh | bash -s -- restore your_backup_file.bck. WARNING: This is a destructive operation — all current data will be replaced with the backup data.

Mytess homepage shows no data on first use?

This is normal! Mytess gets data through the flow: TeslaMate → MQTT (Mosquitto) → TeslaMateAPI → Mytess App. If TeslaMate hasn't pushed any data yet (e.g., after a fresh install or restart), the homepage will appear empty. Solution: Restart all TeslaMate services with: docker compose restart.

How to collect diagnostic info for troubleshooting?

Run: curl -fsSL https://mytess.net/scripts/mytess-tool.sh | bash -s -- diagnose. The tool collects service status, resource usage, and TeslaMateAPI logs. No sensitive data (passwords, tokens) will be included in the report.

How can I get help with TeslaMate?

Join our Telegram group for the fastest support! You can also reach us via email at hi@mytesla.cc, our Discord community, or check the documentation at mytess.net/docs/faq.

What if the address names for charging, parking, and trip start/end points are inaccurate?

TeslaMate uses OpenStreetMap for reverse geocoding by default, which may not always provide accurate address names in some regions. Solution: Replace the TeslaMate image with mytess/teslamate, an enhanced version based on TeslaMate with improved reverse geocoding. Apply for a Google Maps API key with Geocoding API permission enabled, then configure the GOOGLE_MAPS_API_KEY environment variable in your docker-compose.yml. See the mytess/teslamate source code at https://github.com/yekk-me/teslamate/ for details.

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.

홈문서

시작하기

빠른 시작
API 설정

가이드

기능 가이드
자주 묻는 질문

빠른 링크

기능
배포
가격

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 restart to 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 서비스 주소 입력, 형식:

내부 네트워크http://192.168.1.x:3030

공용https://api.example.com

2인증 방법 선택

인증 없음

내부 네트워크 환경 또는 다른 방법으로 보호된 API용

토큰 인증추천

API 서비스 환경 변수에서 설정

API_TOKEN=your_secret_token

Basic 인증

Nginx 등 리버스 프록시에서 사용자명/비밀번호 설정

3원격 접근 (선택)

외부에서 TeslaMate API에 접근하려면:

Cloudflare Tunnel

Tailscale / WireGuard

frp / ngrok

Nginx + Let's Encrypt

Test Connection

설정 후 '연결 테스트'를 클릭하여 확인하세요.

자주 묻는 질문

연결 시간 초과

API 주소, 포트, 방화벽 설정 확인

인증 실패 (401)

인증 방법과 자격 증명 확인

인증서 문제

iOS는 유효한 HTTPS 인증서 필요, Let's Encrypt 추천