🚗 Guía definitiva: Instalar y configurar TeslaMate en Docker (2025)

⚡️ ¿Qué es TeslaMate y por qué deberías instalarlo?

TeslaMate es la plataforma open source más completa para registrar, analizar y visualizar todos los datos de tu Tesla: viajes, cargas, consumos, ubicaciones, eficiencia, alertas y mucho más. Todo bajo tu control, sin depender de servicios de terceros y con la potencia de Grafana para dashboards espectaculares. Si tienes un Tesla y quieres conocerlo a fondo, TeslaMate es imprescindible.

1️⃣ Antes de empezar: ¿no tienes Docker?

TeslaMate funciona sobre Docker, lo que garantiza portabilidad, aislamiento y facilidad de despliegue. Si aún no tienes Docker instalado, consulta nuestra sección Guía desde 0 para tutoriales básicos, o revisa la documentación oficial de TeslaMate que incluye pasos para todos los sistemas.

• Windows: Docker Desktop con WSL2.
• macOS: Docker Desktop para Mac.
• Linux: Instalación con repositorio oficial y comandos optimizados.

¿Listo? ¡Seguimos!

2️⃣ Instalación de TeslaMate con Docker Compose

La forma más sencilla y fiable de instalar TeslaMate es usando Docker Compose. Así tendrás todos los servicios necesarios (TeslaMate, base de datos, Grafana, MQTT) funcionando en minutos.
Basado en la documentación oficial.

Paso 1: Prepara tu entorno

mkdir teslamate && cd teslamate
mkdir -p import

Paso 2: Crea el archivo docker-compose.yml

Copia este archivo en tu carpeta teslamate y personaliza las claves y contraseñas:

# docker-compose.yml
version: '3.8'

services:
  teslamate:
    image: teslamate/teslamate:latest
    restart: always
    environment:
      - ENCRYPTION_KEY=tu_clave_secreta_32_caracteres
      - DATABASE_USER=teslamate
      - DATABASE_PASS=tupasswordseguro
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
      - MQTT_HOST=mosquitto
    ports:
      - 4000:4000
    volumes:
      - ./import:/opt/app/import
    cap_drop:
      - all
    depends_on:
      - database
      - mosquitto

  database:
    image: postgres:16
    restart: always
    environment:
      - POSTGRES_USER=teslamate
      - POSTGRES_PASSWORD=tupasswordseguro
      - POSTGRES_DB=teslamate
    volumes:
      - teslamate-db:/var/lib/postgresql/data

  grafana:
    image: teslamate/grafana:latest
    restart: always
    environment:
      - DATABASE_USER=teslamate
      - DATABASE_PASS=tupasswordseguro
      - DATABASE_NAME=teslamate
      - DATABASE_HOST=database
    ports:
      - 3000:3000
    volumes:
      - teslamate-grafana-data:/var/lib/grafana

  mosquitto:
    image: eclipse-mosquitto:2
    restart: always
    command: mosquitto -c /mosquitto-no-auth.conf
    volumes:
      - mosquitto-conf:/mosquitto/config
      - mosquitto-data:/mosquitto/data

volumes:
  teslamate-db:
  teslamate-grafana-data:
  mosquitto-conf:
  mosquitto-data:

Importante: Usa una clave segura para ENCRYPTION_KEY y contraseñas fuertes para la base de datos.

Paso 3: Lanza los contenedores

docker compose up -d

Verifica que todo está funcionando con docker compose ps. Deberías ver los servicios teslamate, database, grafana y mosquitto activos.

3️⃣ Primeros pasos y configuración inicial

1. Abre http://localhost:4000 (o la IP de tu servidor) en el navegador.
2. La primera vez, TeslaMate te pedirá los tokens de acceso de Tesla. Puedes generarlos fácilmente con:
   • Generador web oficial de tokens TeslaMate
   • Guía oficial para obtener tokens Tesla API
   Sigue las instrucciones de cada herramienta para obtener tu access_token y refresh_token.
3. Pega los tokens en el formulario de TeslaMate y ¡listo! Empezará a registrar datos de tu Tesla en tiempo real.

4️⃣ Casos de uso detallados y ejemplos prácticos

• Monitorización de cargas: Visualiza cuánto, cuándo y dónde cargas tu Tesla. Por ejemplo, puedes ver si aprovechas las tarifas nocturnas o si alguna carga fue ineficiente. TeslaMate muestra el coste, la energía recibida y el historial de cada carga, ideal para optimizar el gasto energético.
  Ejemplo: Consulta en el panel de Grafana un gráfico con todas las cargas del mes, su coste y el lugar donde se realizaron.
• Historial de viajes y rutas: Analiza cada trayecto con mapas, velocidades, consumos y eficiencia. ¿Quieres saber cuánto gastas en un viaje habitual o comparar rutas alternativas? TeslaMate lo muestra con todo detalle, incluso con búsquedas automáticas de direcciones y resúmenes semanales.
  Ejemplo: Busca un viaje específico y revisa el consumo medio, el tiempo total y los puntos de recarga intermedios.
• Alertas y automatizaciones: Configura notificaciones (por ejemplo, si la batería baja de cierto nivel, si el coche queda abierto o si hay un gasto anómalo). Puedes integrarlo con Home Assistant o Telegram para recibir avisos en tiempo real.
  Ejemplo: Recibe un mensaje en Telegram si el coche se queda abierto durante más de 15 minutos.
• Integración con Home Assistant: Usa MQTT para que Home Assistant reciba datos en vivo: nivel de batería, estado de carga, ubicación, puertas abiertas, etc. Así puedes crear reglas automáticas, como encender la luz del garaje cuando llegas a casa o ajustar la climatización antes de salir.
  Ejemplo: Automatiza la apertura de la puerta del garaje cuando el Tesla entra en la geocerca de tu casa.
• Paneles personalizados en Grafana: Crea tus propios dashboards para visualizar exactamente lo que te interesa: eficiencia por estación del año, comparativa de costes entre puntos de carga, consumo por tipo de trayecto, etc.
  Ejemplo: Un panel que compara el consumo del Tesla en verano frente a invierno.
• Control de costes: Añade precios personalizados por ubicación (geocercas) y obtén informes automáticos del gasto mensual, ideal para quienes cargan en diferentes lugares o quieren controlar el presupuesto al céntimo.
  Ejemplo: Configura el precio de la electricidad en casa y en el trabajo para ver el coste real de cada carga.
• Exportación de datos: Descarga tus datos en CSV para análisis avanzados o para compartir con tu gestor o comunidad.
  Ejemplo: Exporta todos los viajes realizados en el último año para un informe personalizado.

5️⃣ Beneficios de usar TeslaMate (y Docker) en tu Tesla

• Privacidad total: Tus datos nunca salen de tu red local. A diferencia de servicios cloud, todo se almacena en tu servidor o NAS.
• Visualización avanzada: Grafana ofrece paneles espectaculares, personalizables y exportables. Puedes ver desde el consumo de cada trayecto hasta estadísticas de eficiencia a largo plazo.
• Automatización y alertas: Recibe notificaciones inteligentes y crea reglas automáticas con Home Assistant, Telegram o cualquier plataforma compatible con MQTT.
• Optimización de costes y eficiencia: Analiza tu forma de conducir, detecta hábitos ineficientes y planifica cargas para ahorrar dinero y batería.
• Portabilidad y facilidad de despliegue: Gracias a Docker, puedes mover tu instalación entre equipos, hacer backups y restaurar en segundos, o incluso migrar a la nube si lo necesitas.
• Aislamiento y seguridad: Docker mantiene TeslaMate aislado del resto del sistema, evitando conflictos y facilitando actualizaciones.
• Escalabilidad y mantenimiento sencillo: Añade más servicios (como bases de datos externas, almacenamiento en red, etc.) o actualiza TeslaMate fácilmente con docker compose pull && docker compose up -d.
• Comunidad activa y soporte: TeslaMate es open source, con una comunidad muy activa y actualizaciones frecuentes.

6️⃣ Accede a tus datos y paneles

• TeslaMate: http://localhost:4000 (o la IP de tu servidor)
• Grafana: http://localhost:3000 (usuario/contraseña por defecto: admin/admin, cámbiala en el primer acceso)

7️⃣ Actualización, backup y mantenimiento

• Actualizar TeslaMate: docker compose pull docker compose up -d --force-recreate
• Backup de la base de datos: docker compose exec database pg_dump -U teslamate teslamate > teslamate_backup_$(date +%Y-%m-%d).sql
• Limpiar datos antiguos: docker compose exec teslamate /app/bin/teslamate rpc "TeslaMate.Repo.query(\"SELECT delete_old_positions()\")"

8️⃣ Solución de problemas comunes

9️⃣ Recursos útiles y comunidad

• Guía desde 0 (Learning AI Agents)
• Instalación oficial de TeslaMate
• Repositorio oficial de TeslaMate en GitHub
• Dashboard TeslaMate para Grafana
• Generador de tokens TeslaMate (web oficial)
• Guía oficial para obtener tokens Tesla API

🎸 Conclusión

Con TeslaMate y Docker, transformas tu Tesla en una fuente inagotable de datos útiles, visualmente atractivos y bajo tu control. Desde la optimización de costes hasta la integración domótica, pasando por la privacidad y la facilidad de mantenimiento, TeslaMate es la herramienta definitiva para cualquier usuario avanzado de Tesla.