ES Configuration - KnevS/Tesla-Carview GitHub Wiki

🌐 Idioma: EN · DE · FR · ES · TR · EL


Configuración — Variables de entorno

Todos los ajustes de Tesla Carview se configuran a través del archivo .env en /opt/tesla-carview/backend/.env.

Tras cualquier cambio en .env, reinicia el backend:

docker compose -f /opt/tesla-carview/docker-compose.prod.yml up -d --build backend

Ajustes necesarios (imprescindibles para que funcione la app)

Variable Ejemplo Descripción
JWT_SECRET some-random-64-char-string Clave secreta para firmar tokens de sesión. Genera con: openssl rand -hex 32
TESLA_CLIENT_ID abc123... Del Tesla Developer Portal
TESLA_CLIENT_SECRET xyz789... Del Tesla Developer Portal
TESLA_AUTH_BASE https://auth.tesla.com/oauth2/v3 URL base OAuth de Tesla — completada automáticamente por el wizard; solo cambiar si Tesla actualiza su endpoint
FRONTEND_URL https://tesla.tudominio.com La URL pública de tu instalación
DATABASE_PATH /app/data Dónde se almacenan las bases de datos (no cambiar en Docker)

Opcionales pero recomendados

Variable Por defecto Descripción
AUTO_UPDATE_ENABLED false Establecer a true para actualizaciones automáticas nocturnas
MFA_REQUIRED_FOR_NEW_USERS false Forzar configuración MFA para todas las nuevas cuentas de usuario
REGISTRATION_REQUIRES_INVITE false Requerir un código de invitación para registrar un nuevo inquilino
POLL_INTERVAL_MS 60000 Con qué frecuencia consultar la API Tesla cuando el coche está activo (ms)
POLL_SLEEP_INTERVAL_MS 600000 Intervalo de consulta cuando el coche está durmiendo (ms)

Tarifa dinámica (precio de electricidad)

Variable Descripción
AWATTAR_ENABLED true/false — activar aWATTar (DE/AT, gratuito)
TIBBER_TOKEN Tu token API de Tibber (obtén en developer.tibber.com)

Modo demo

Variable Por defecto Descripción
DEMO_ENABLED false Activar inquilino demo público con datos ficticios
DEMO_MAX_CONCURRENT 10 Máximo de usuarios demo simultáneos
DEMO_LIFETIME_DAYS 14 Duración de las cuentas demo

Avanzado / Fleet Telemetry

Variable Descripción
FLEET_TELEMETRY_ENABLED true/false — activar GPS en tiempo real via Fleet Telemetry
FLEET_TELEMETRY_PORT Puerto para el servidor Fleet Telemetry (por defecto: 4443)
VIRTUAL_KEY_PRIVATE_KEY_PATH Ruta al archivo de clave privada de la Virtual Key

Cómo generar un JWT_SECRET seguro

openssl rand -hex 32
# Resultado: algo como a8f3e9b2c1d4...
# Copia esto en tu archivo .env

Verificar tu configuración actual

# Ver el .env actual (cuidado al compartir la salida — contiene secretos):
cat /opt/tesla-carview/backend/.env

# Verificar qué variables de entorno ve el contenedor en ejecución:
docker compose -f /opt/tesla-carview/docker-compose.prod.yml exec backend env | grep -v PASSWORD | grep -v SECRET

Referencia completa

Para una lista completa de todas las variables de entorno con descripciones detalladas, consulta la documentación técnica: docs/10-configuration.en.md