Il file Compose di origine è utile come esempio di percorso per ZimaOS, ma non è mai stato confermato dall'autore originale e non dovrebbe essere considerato definitivo come stack TeslaMate corrente. La documentazione Docker mantenuta di TeslaMate utilizza ancora una distribuzione Compose multi-container e raccomanda esplicitamente di eseguire il servizio su una macchina sempre accesa, con database e stato di Grafana persistenti.
Le indicazioni upstream attuali sottolineano inoltre l'importanza della sicurezza, poiché TeslaMate memorizza i token API di Tesla. Mantieni il servizio su una rete domestica attendibile oppure fai passare l'accesso remoto attraverso una VPN/Tailscale/Cloudflare Tunnel o un reverse proxy adeguatamente protetto, invece di pubblicare direttamente la WebUI grezza.
Verifica i requisiti attuali di TeslaMate
La documentazione attuale di TeslaMate indica:
- Docker/Compose;
- un host sempre acceso;
- almeno 1 GB di RAM per l'installazione, con 2 GB consigliati;
- accesso a Internet ai servizi Tesla;
- hardware amd64 o arm64.
Consulta l'installazione Docker attuale di TeslaMate.
Il file di origine ha spostato correttamente i dati persistenti in /DATA/AppData
Il file Compose della community memorizzava i dati di Postgres, i dati di Grafana e i dati importati in cartelle AppData dedicate di ZimaOS. Si tratta di un adattamento corretto alla piattaforma: lo stato dei container dovrebbe essere persistente e trovarsi al di fuori del file system temporaneo del container.
Proteggi il database PostgreSQL
Il database di TeslaMate contiene i dati storici del veicolo e lo stato dell'applicazione. Esegui un backup prima degli aggiornamenti delle immagini o di modifiche importanti a Compose.
Non collocare la directory dei dati PostgreSQL in uso su una condivisione di rete inaffidabile e non eliminarla durante la pulizia dei container.
Usa una ENCRYPTION_KEY sicura
TeslaMate utilizza la chiave di crittografia per proteggere i token API Tesla memorizzati. Il segnaposto di origine indica “un po' di sale per la crittografia”; sostituiscilo con un segreto casuale robusto e non divulgarlo in screenshot pubblici o post sui forum.
Usa una sola password del database, coerente e sicura
Il testo di origine osserva correttamente che la password del database deve corrispondere nella configurazione di Postgres, TeslaMate e Grafana. Una mancata corrispondenza può sembrare un problema di avvio dell'applicazione, anche se i container sono in esecuzione.
Il testo di origine ha disabilitato MQTT; l'upstream attuale lo include nello stack standard
Il file Compose della community impostava DISABLE_MQTT=true. Le indicazioni Docker attuali di TeslaMate includono Mosquitto nell'esempio standard. MQTT rimane opzionale a seconda delle integrazioni, ma gli utenti attuali dovrebbero seguire lo stack upstream di cui hanno effettivamente bisogno, invece di ereditare automaticamente una semplificazione del 2025.
Proteggi anche Grafana
Il testo di origine impostava su true l'accesso anonimo a Grafana. Può essere comodo su una LAN privata, ma espone i dashboard del veicolo a chiunque possa raggiungere la porta. Per l'accesso remoto, usa l'autenticazione e un percorso di rete protetto.
Aggiorna deliberatamente l'intero stack
Prima dell'aggiornamento, esegui il backup del database, consulta le note di rilascio di TeslaMate, scarica le nuove immagini, ricrea lo stack e verifica successivamente la raccolta dei dati Tesla e i dashboard di Grafana.
Domande frequenti su TeslaMate su ZimaOS
L'autore originale ha confermato che il file Compose della community funzionava?
No. Ha detto che avrebbe provato, ma la discussione non contiene alcun risultato.
Quali dati devono essere persistenti?
Come minimo, il database di TeslaMate/Postgres e lo stato di Grafana; proteggi anche eventuali dati aggiuntivi importati o configurati.
È consigliabile esporre TeslaMate direttamente su Internet?
Le indicazioni attuali di TeslaMate raccomandano una connessione sicura, ad esempio tramite VPN, Cloudflare Tunnel, Tailscale, ZeroTier o un reverse proxy adeguatamente protetto.
