EL Installation

Οδηγός Εγκατάστασης

🤖 Αυτή η ελληνική μετάφραση είναι υποστηριζόμενη από AI από το αγγλικό πρωτότυπο. Διορθώσεις ευπρόσδεκτες μέσω GitHub.

🌐 Γλώσσα: EN · DE · FR · ES · TR · EL

Απαιτούμενος χρόνος: ~30 λεπτά | Δυσκολία: Φιλικό για αρχάριους

Αυτός ο οδηγός σας καθοδηγεί σε μια πλήρη εγκατάσταση TeslaView από την αρχή.

---

Τι χρειάζεστε πριν ξεκινήσετε

Πριν αγγίξετε οποιεσδήποτε εντολές, βεβαιωθείτε ότι έχετε:

• Έναν διακομιστή Linux, VPS ή Raspberry Pi (δείτε επιλογές υλικού παρακάτω)
• Ένα όνομα τομέα που δείχνει στον διακομιστή σας — Ή σχέδιο να χρησιμοποιήσετε DynDNS / Cloudflare Tunnel (→ Network Access)
• Έναν λογαριασμό Tesla Developer (→ Tesla API Setup)
• Πρόσβαση SSH στον διακομιστή σας (ή πληκτρολόγιο + οθόνη στο Pi)

---

Επιλογές υλικού

Επιλογή 1: Raspberry Pi (οικιακός διακομιστής)

Καλύτερο για: προσωπική χρήση στο σπίτι, χαμηλό κόστος (~€60–120 συνολικά)

Μοντέλο	RAM	Συνιστώμενος αποθηκευτικός χώρος
Raspberry Pi 5 (συνιστάται)	4 GB ή 8 GB	NVMe SSD μέσω M.2 HAT+
Raspberry Pi 4	4 GB	USB SSD
Raspberry Pi 3	1 GB	δεν υποστηρίζεται πλέον ¹

¹ Το Raspberry Pi 3 και παλαιότερα (32-bit ARM) δεν υποστηρίζονται πλέον από την v3.51.0: η Node.js δεν δημοσιεύει εικόνες ARMv7 από την έκδοση 24 και μετά.

⚠️ Σημαντικό: Μην χρησιμοποιείτε κάρτα SD για μόνιμη λειτουργία. Θα αποτύχει μέσα σε μήνες υπό το φόρτο εγγραφής του TeslaView. Δείτε Raspberry Pi Storage για διόρθωση 20 λεπτών.

Επιλογή 2: VPS σε πάροχο hosting

Καλύτερο για: διαθεσιμότητα 24/7, χωρίς υλικό προς διαχείριση, εύκολη ρύθμιση

Πάροχος	Μηνιαίο κόστος	Σημειώσεις
Hetzner CX22	~€4.35	Συνιστάται, πολύ αξιόπιστο
netcup VPS 1000	~€4.44	Γερμανικά κέντρα δεδομένων
Contabo VPS S	~€5.99	Άφθονος αποθηκευτικός χώρος

Ένα VPS έχει σταθερή δημόσια διεύθυνση IP — δεν απαιτείται ρύθμιση DynDNS.

---

Βήμα 1: Προετοιμάστε τον διακομιστή

Συνδεθείτε στον διακομιστή σας μέσω SSH (ή ανοίξτε ένα τερματικό στο Pi):

ssh root@YOUR-SERVER-IP

Βεβαιωθείτε ότι το σύστημα είναι ενημερωμένο:

apt update && apt upgrade -y

---

Βήμα 2: Αποκτήστε έναν τομέα που δείχνει στον διακομιστή σας

Το TeslaView απαιτεί HTTPS (το API της Tesla λειτουργεί μόνο μέσω ασφαλών συνδέσεων). Αυτό σημαίνει ότι χρειάζεστε έναν τομέα με έγκυρο πιστοποιητικό SSL.

Έχω ένα VPS με σταθερή IP: → Μεταβείτε στον καταχωρητή τομέα σας και δημιουργήστε μια εγγραφή A:

tesla.yourdomain.com  →  A  →  YOUR-VPS-IP

Περιμένετε 5–30 λεπτά για να διαδοθεί το DNS, μετά συνεχίστε.

Είμαι στο σπίτι χωρίς σταθερή IP: → Δείτε Network Access — ρυθμίστε DynDNS ή Cloudflare Tunnel πρώτα, μετά επιστρέψτε εδώ.

Δεν έχω καθόλου τομέα: → Αποκτήστε έναν δωρεάν υποτομέα στο DuckDNS.org (π.χ. my-tesla.duckdns.org) — είναι δωρεάν και λειτουργεί με Let's Encrypt.

---

Βήμα 3: Εκτελέστε το script εγκατάστασης

Αυτή η μοναδική εντολή κατεβάζει και εκτελεί τον διαδραστικό οδηγό εγκατάστασης:

curl -fsSL https://raw.githubusercontent.com/KnevS/Tesla-Carview/main/deploy/setup.sh | bash

Ο οδηγός σας ρωτά μια σειρά ερωτήσεων:

Ερώτηση	Τι να εισαγάγετε
Όνομα τομέα	tesla.yourdomain.com ή my-tesla.duckdns.org
Όνομα χρήστη διαχειριστή	Οποιοδήποτε όνομα (π.χ. το όνομά σας, admin)
Κωδικός πρόσβασης διαχειριστή	Ισχυρός κωδικός πρόσβασης (ελάχ. 12 χαρακτήρες)
Όνομα μισθωτή	Πώς να καλέσετε την εγκατάστασή σας (π.χ. "My Tesla")
Ενεργοποίηση HTTPS	Ναι (πάντα — απαιτείται για το Tesla API)

Το script ζητά τη λειτουργία ανάπτυξης πριν κάνει οτιδήποτε:

Λειτουργία	Πότε να χρησιμοποιηθεί
1 — Direct	Αποκλειστικό VM ή VPS χωρίς υπάρχον proxy — nginx + certbot εγκαθίστανται και διαμορφώνονται αυτόματα
2 — Proxy	Ήδη τρέχει nginx, Caddy, Traefik ή ρύθμιση WireGuard+VPS — η εγκατάσταση nginx παραλείπεται εντελώς

Στη λειτουργία Proxy, προσθέστε αυτό στην υπάρχουσα διαμόρφωση του proxy σας:

proxy_pass http://127.0.0.1:8080;

Το script τότε αυτόματα (λειτουργία Direct):

1. Εγκαθιστά Docker, nginx, certbot, fail2ban
2. Αποκτά ένα πιστοποιητικό SSL Let's Encrypt για τον τομέα σας
3. Διαμορφώνει το nginx με κεφαλίδες ασφαλείας
4. Ξεκινά όλα τα Docker containers
5. Ρυθμίζει τη βάση δεδομένων

Αυτό διαρκεί 5–10 λεπτά.

---

Βήμα 4: Πρώτη σύνδεση

Ανοίξτε τον περιηγητή σας και μεταβείτε στο https://tesla.yourdomain.com

Θα πρέπει να δείτε τη σελίδα σύνδεσης του TeslaView. Εισαγάγετε το όνομα χρήστη και τον κωδικό πρόσβασης διαχειριστή που ορίσατε στο Βήμα 3.

💡 Συμβουλή: Επιλέξτε "Stay signed in (90 days)" στη σελίδα σύνδεσης ώστε να μην χρειάζεται να πληκτρολογείτε τον κωδικό πρόσβασής σας κάθε φορά — ιδιαίτερα χρήσιμο κατά την πρόσβαση από τον περιηγητή Tesla.

---

Βήμα 5: Συνδέστε τον λογαριασμό Tesla σας

Μετά τη σύνδεση, θα δείτε μια προτροπή εγκατάστασης για σύνδεση του λογαριασμού Tesla σας. Ακολουθήστε τις οδηγίες στο Tesla API Setup.

---

Βήμα 6: Έτοιμοι!

Η εγκατάσταση του TeslaView τρέχει. Η εφαρμογή θα ξεκινήσει αυτόματα το polling των δεδομένων του οχήματός σας.

Τι να κάνετε στη συνέχεια:

• Ρυθμίστε το όχημά σας → Dashboard → Add Vehicle
• Διαμορφώστε ειδοποιήσεις → Settings → Push Notifications
• Προσκαλέστε μέλη της οικογένειας → Admin → Users → Invite
• Ρυθμίστε μια τοποθεσία φόρτισης → Settings → Charging Locations

---

Ενημέρωση

Το TeslaView μπορεί να ενημερώνεται αυτόματα. Ενεργοποιήστε το στις ρυθμίσεις:

# In /opt/tesla-carview/backend/.env:
AUTO_UPDATE_ENABLED=true

Ή ενημερώστε χειροκίνητα:

cd /opt/tesla-carview
git pull
docker compose -f docker-compose.prod.yml up -d --build

---

Αντιμετώπιση προβλημάτων εγκατάστασης

"Permission denied" κατά την εκτέλεση του script → Βεβαιωθείτε ότι εκτελείτε ως root. Εκτελέστε πρώτα sudo su.

"Domain not found" κατά τη διάρκεια του certbot → Το DNS σας δεν έχει διαδοθεί ακόμα. Περιμένετε 10–30 λεπτά και δοκιμάστε ξανά. Ελέγξτε με: nslookup tesla.yourdomain.com

Τα containers δεν ξεκινούν → Ελέγξτε τα logs: docker compose -f /opt/tesla-carview/docker-compose.prod.yml logs

Περισσότερη βοήθεια → Troubleshooting | Open an Issue

---

Windows PC αντί για διακομιστή (από v3.53.0)

Η εφαρμογή τρέχει εξ ολοκλήρου σε Linux containers — τα Windows είναι μόνο ο host. Με Docker Desktop σε λειτουργία WSL2 ξεκινά η ίδια στοίβα. Το script deploy/setup.sh δεν λειτουργεί εκεί (bash, apt, systemd, certbot)· τη θέση του παίρνει το deploy\setup-windows.ps1.

git clone https://github.com/KnevS/Tesla-Carview.git
cd Tesla-Carview
powershell -ExecutionPolicy Bypass -File .\deploy\setup-windows.ps1

Δύο περιορισμοί, και οι δύο μετρημένοι: οι εντολές προς το όχημα δεν λειτουργούν (ο tesla-http-proxy χρειάζεται bind mount Linux και σταθερό UID) και όποιος τρέχει παρ' όλα αυτά τον proxy πρέπει να ορίσει TESLA_PROXY_BASE — στο Docker Desktop το host.docker.internal δείχνει στο host gateway αντί για το container του proxy. Όλα τα αναγνωστικά λειτουργούν πλήρως.

Τα Windows δεν ελέγχονται από CI. Πλήρης περιγραφή: docs/02-deployment.el.md, ενότητα «Windows (Docker Desktop)».