DE Installation - KnevS/Tesla-Carview GitHub Wiki
Installationsanleitung
🌐 Sprache / Language: EN · FR · ES · TR · EL · DE
Zeitaufwand: ~30 Minuten | Schwierigkeitsgrad: Einsteigerfreundlich
Diese Anleitung führt dich durch eine vollständige Tesla Carview Installation von Grund auf.
Was du vorher brauchst
Bevor du irgendeinen Befehl eingibst, stelle sicher, dass du Folgendes hast:
- Einen Linux-Server, VPS oder Raspberry Pi (siehe Hardware-Optionen unten)
- Einen Domainnamen, der auf deinen Server zeigt — ODER du planst DynDNS / Cloudflare Tunnel zu nutzen (→ Netzwerkzugang)
- Einen Tesla Developer Account (→ Tesla API Setup)
- SSH-Zugang zu deinem Server (oder Tastatur + Bildschirm am Pi)
Hardware-Optionen
Option 1: Raspberry Pi (Heimserver)
Ideal für: persönlichen Einsatz zuhause, geringe Kosten (~60–120 € gesamt)
| Modell | RAM | Empfohlener Speicher |
|---|---|---|
| Raspberry Pi 5 (empfohlen) | 4 GB oder 8 GB | NVMe SSD via M.2 HAT+ |
| Raspberry Pi 4 | 4 GB | USB SSD |
| Raspberry Pi 3 | 1 GB | nicht mehr unterstützt ¹ |
¹ Raspberry Pi 3 und älter (32-Bit-ARM) werden seit v3.51.0 nicht mehr unterstützt: Node.js veröffentlicht ab Version 24 keine ARMv7-Images mehr.
Wichtig: Verwende keine SD-Karte für den Dauerbetrieb. Sie wird unter der Schreiblast von Tesla Carview innerhalb weniger Monate ausfallen. Siehe Raspberry Pi Speicher für eine 20-Minuten-Lösung.
Option 2: VPS bei einem Hosting-Anbieter
Ideal für: 24/7 Verfügbarkeit, keine Hardware zu verwalten, einfaches Setup
| Anbieter | Monatliche Kosten | Hinweise |
|---|---|---|
| Hetzner CX22 | ~4,35 € | Empfohlen, sehr zuverlässig |
| netcup VPS 1000 | ~4,44 € | Deutsche Rechenzentren |
| Contabo VPS S | ~5,99 € | Viel Speicher |
Ein VPS hat eine feste öffentliche IP-Adresse — kein DynDNS-Setup nötig.
Schritt 1: Server vorbereiten
Verbinde dich per SSH mit deinem Server (oder öffne ein Terminal auf dem Pi):
ssh root@DEINE-SERVER-IP
Stelle sicher, dass das System aktuell ist:
apt update && apt upgrade -y
Schritt 2: Domain auf deinen Server zeigen lassen
Tesla Carview benötigt HTTPS (Teslas API funktioniert nur über sichere Verbindungen). Das bedeutet, du brauchst eine Domain mit einem gültigen SSL-Zertifikat.
Ich habe einen VPS mit fester IP: → Gehe zu deinem Domain-Registrar und erstelle einen A-Record:
tesla.meinedomain.de → A → DEINE-VPS-IP
Warte 5–30 Minuten auf die DNS-Ausbreitung, dann weiter.
Ich bin zuhause ohne feste IP: → Siehe Netzwerkzugang — richte zuerst DynDNS oder Cloudflare Tunnel ein, dann komme hierher zurück.
Ich habe gar keine Domain:
→ Hole dir eine kostenlose Subdomain bei DuckDNS.org (z.B. mein-tesla.duckdns.org) — kostenlos und funktioniert mit Let's Encrypt.
Schritt 3: Setup-Skript ausführen
Dieser einzelne Befehl lädt den interaktiven Setup-Wizard herunter und startet ihn:
curl -fsSL https://raw.githubusercontent.com/KnevS/Tesla-Carview/main/deploy/setup.sh | bash
Der Wizard stellt dir eine Reihe von Fragen:
| Frage | Was du eingeben sollst |
|---|---|
| Domainname | tesla.meinedomain.de oder mein-tesla.duckdns.org |
| Admin-Benutzername | Beliebiger Name (z.B. dein Vorname, admin) |
| Admin-Passwort | Ein starkes Passwort (min. 12 Zeichen) |
| Tenant-Name | Wie deine Installation heißen soll (z.B. „Mein Tesla") |
| HTTPS aktivieren | Ja (immer — erforderlich für Tesla API) |
Das Skript fragt zunächst nach dem Deployment-Modus:
| Modus | Wann verwenden |
|---|---|
| 1 — Direkt | Dedizierte VM/VPS ohne bestehenden Proxy — nginx + certbot werden automatisch installiert und konfiguriert |
| 2 — Proxy | nginx, Caddy, Traefik oder WireGuard+VPS bereits vorhanden — nginx-Installation wird komplett übersprungen |
Im Proxy-Modus folgendes in die bestehende Proxy-Konfiguration eintragen:
proxy_pass http://127.0.0.1:8080;
⚠️ Im Proxy-Modus musst du die Rate-Limits selbst nachbauen —
setup.shlegt in diesem Modus keine nginx-Konfiguration an. Fehlen sie oder sind sie zu eng, läuft die App in HTTP 429: halb geladene Seiten, die scheinbar nur ein Neuladen repariert.
Pfad Empfehlung Warum /api/auth/login10/min, Burst 3 Brute-Force-Schutz /api/tiles/1200/min, Burst 300 Ein Karten-Zoom lädt 50–150 Kacheln auf einmal /api/(Rest)120/min, Burst ≥ 60 Ein Seitenwechsel feuert 15–26 Anfragen Der spezifischere Pfad muss gewinnen — sonst sperrt ein einziger Karten-Zoom die gesamte API aus. Vorlagen:
deploy/nginx-host.conf.templateunddeploy/traefik-dynamic.example.yml.
Das Skript erledigt dann automatisch (Modus Direkt):
- Docker, nginx, certbot, fail2ban installieren
- Let's Encrypt SSL-Zertifikat für deine Domain holen
- nginx mit Sicherheits-Headern konfigurieren
- Alle Docker-Container starten
- Datenbank einrichten
Das dauert 5–10 Minuten.
Schritt 4: Erster Login
Öffne deinen Browser und gehe zu https://tesla.meinedomain.de
Du solltest die Tesla Carview Anmeldeseite sehen. Gib den Admin-Benutzernamen und das Passwort ein, das du in Schritt 3 gesetzt hast.
Tipp: Aktiviere „Angemeldet bleiben (90 Tage)" auf der Login-Seite, damit du dein Passwort nicht jedes Mal eingeben musst — besonders praktisch beim Zugriff aus dem Tesla-Browser.
Schritt 5: Tesla-Konto verbinden
Nach dem Login siehst du eine Aufforderung, dein Tesla-Konto zu verbinden. Befolge die Anweisungen in Tesla API Setup.
Schritt 6: Fertig!
Deine Tesla Carview Installation läuft. Die App beginnt automatisch, die Fahrzeugdaten abzurufen.
Was du als nächstes tun kannst:
- Fahrzeug einrichten → Dashboard → Fahrzeug hinzufügen
- Benachrichtigungen konfigurieren → Einstellungen → Push-Benachrichtigungen
- Familienmitglieder einladen → Admin → Benutzer → Einladen
- Ladestandort einrichten → Einstellungen → Ladestandorte
Updates einspielen
Tesla Carview kann sich automatisch aktualisieren. Aktiviere es in den Einstellungen:
# In /opt/tesla-carview/backend/.env:
AUTO_UPDATE_ENABLED=true
Oder manuell aktualisieren:
cd /opt/tesla-carview
git pull
docker compose -f docker-compose.prod.yml up -d --build
Probleme bei der Installation
„Permission denied" beim Ausführen des Skripts
→ Stelle sicher, dass du als root arbeitest. Führe zuerst sudo su aus.
„Domain not found" bei certbot
→ Dein DNS hat sich noch nicht ausgebreitet. Warte 10–30 Minuten und versuche es erneut. Prüfe mit: nslookup tesla.meinedomain.de
Container starten nicht
→ Logs prüfen: docker compose -f /opt/tesla-carview/docker-compose.prod.yml logs
Weitere Hilfe → Fehlerbehebung | Issue öffnen
Dieses Wiki wird automatisch aus dem Repository generiert. Zuletzt aktualisiert: siehe Commits.
Windows-PC statt Server (ab v3.53.0)
Die Anwendung läuft vollständig in Linux-Containern — Windows ist nur der Host. Mit Docker Desktop im WSL2-Modus startet derselbe Stack. Das Setup-Skript deploy/setup.sh funktioniert dort nicht (bash, apt, systemd, certbot); an seiner Stelle steht deploy\setup-windows.ps1.
git clone https://github.com/KnevS/Tesla-Carview.git
cd Tesla-Carview
powershell -ExecutionPolicy Bypass -File .\deploy\setup-windows.ps1
Zwei Einschränkungen, beide gemessen: Fahrzeugbefehle funktionieren nicht (der tesla-http-proxy braucht einen Linux-Bind-Mount und eine feste UID), und wer den Proxy doch betreibt, muss TESLA_PROXY_BASE setzen — unter Docker Desktop zeigt host.docker.internal auf das Host-Gateway statt auf den Proxy-Container. Alles Lesende ist vollständig nutzbar.
Windows wird nicht in der CI geprüft. Vollständige Beschreibung: docs/02-deployment.md, Abschnitt „Windows (Docker Desktop)".