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 服务

1配置 API 地址

输入您部署的 TeslaMate API 服务地址，格式为

内网http://192.168.1.x:3030

公网https://api.example.com

2选择认证方式

无需认证

适用于内网环境或已通过其他方式保护的 API

Token 认证推荐

在 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