El compose de origen es útil como ejemplo de una ruta de ZimaOS, pero nunca fue confirmado por el autor original y no debería establecerse como la pila actual de TeslaMate. La documentación de Docker mantenida de TeslaMate todavía utiliza una implementación de Compose con varios contenedores y recomienda explícitamente ejecutar el servicio en una máquina siempre encendida con un estado persistente de la base de datos y Grafana.
La guía actual del proyecto también hace hincapié en la seguridad, ya que TeslaMate almacena tokens de la API de Tesla. Mantén el servicio en una red doméstica de confianza o coloca el acceso remoto detrás de una VPN/Tailscale/Cloudflare Tunnel o de un proxy inverso reforzado, en lugar de publicar directamente la WebUI sin protección.
Comprueba los requisitos actuales de TeslaMate
La documentación actual de TeslaMate indica:
- Docker/Compose;
- un host siempre encendido;
- al menos 1 GB de RAM para la instalación, aunque se recomiendan 2 GB;
- acceso a Internet a los servicios de Tesla;
- hardware amd64 o arm64.
Consulta la instalación actual de TeslaMate con Docker.
El origen trasladó correctamente los datos persistentes a /DATA/AppData
El compose de la comunidad almacenaba los datos de Postgres, los datos de Grafana y los datos importados en carpetas dedicadas de AppData de ZimaOS. Es una adaptación adecuada a la plataforma: el estado de los contenedores debe persistir fuera del sistema de archivos desechable del contenedor.
Protege la base de datos PostgreSQL
La base de datos de TeslaMate contiene datos históricos del vehículo y el estado de la aplicación. Haz una copia de seguridad antes de actualizar las imágenes o realizar cambios importantes en Compose.
No coloques el directorio de datos activo de Postgres en un recurso compartido de red poco fiable ni lo elimines al limpiar los contenedores.
Usa una ENCRYPTION_KEY segura
TeslaMate utiliza la clave de cifrado para proteger los tokens almacenados de la API de Tesla. El marcador de posición del origen dice «alguna sal para el cifrado»; sustitúyelo por un secreto aleatorio seguro y no lo incluyas en capturas de pantalla públicas ni en publicaciones de foros.
Usa una única contraseña segura y coherente para la base de datos
El origen señala correctamente que la contraseña de la base de datos debe coincidir en la configuración de Postgres, TeslaMate y Grafana. Una discrepancia puede parecer un problema de inicio de la aplicación aunque los contenedores estén funcionando.
El origen desactivó MQTT; el proyecto actual lo incluye en la pila estándar
El compose de la comunidad establecía DISABLE_MQTT=true. La guía actual de Docker de TeslaMate incluye Mosquitto en el ejemplo estándar. MQTT sigue siendo opcional según las integraciones, pero los usuarios actuales deben seguir la pila del proyecto que realmente necesiten, en lugar de heredar automáticamente una simplificación de 2025.
Protege también Grafana
El origen establecía en true el acceso anónimo a Grafana. Puede resultar práctico en una LAN privada, pero expone los paneles del vehículo a cualquiera que pueda acceder al puerto. Para el acceso remoto, utiliza autenticación y una ruta de red protegida.
Actualiza toda la pila de forma deliberada
Antes de actualizar, haz una copia de seguridad de la base de datos, revisa las notas de la versión de TeslaMate, descarga las nuevas imágenes, recrea la pila y comprueba después la recopilación de datos de Tesla y los paneles de Grafana.
Preguntas frecuentes sobre TeslaMate en ZimaOS
¿El autor original confirmó que el Compose de la comunidad funcionaba?
No. Dijo que lo probaría, pero el hilo no contiene ningún resultado.
¿Qué datos deben persistir?
Como mínimo, la base de datos de TeslaMate/Postgres y el estado de Grafana; protege también cualquier otro dato importado o configurado.
¿Debería exponerse TeslaMate directamente a Internet pública?
La guía actual de TeslaMate recomienda una conexión segura, como una VPN, Cloudflare Tunnel, Tailscale, ZeroTier o un proxy inverso reforzado.
