UK Installation

Інструкція з встановлення

🤖 Цей український переклад створений з AI-підтримкою з англійського оригіналу. Виправлення приймаються на GitHub.

🌐 Мова: EN · DE · FR · ES · TR · EL · UK

Потрібен час: ~30 хвилин | Складність: дружня до новачків

Ця інструкція проведе вас через повне встановлення Tesla Carview з нуля.

---

Що вам потрібно перед початком

Перш ніж торкатися будь-яких команд, переконайтеся, що ви маєте:

• Linux-сервер, VPS або Raspberry Pi (див. варіанти обладнання нижче)
• Доменне ім'я, що вказує на ваш сервер — АБО плани використовувати DynDNS / Cloudflare Tunnel (→ Доступ через мережу)
• Обліковий запис Tesla Developer (→ Налаштування Tesla API)
• SSH-доступ до вашого сервера (або клавіатура + екран на Pi)

---

Варіанти обладнання

Варіант 1: Raspberry Pi (домашній сервер)

Найкраще для: особистого використання вдома, низька вартість (~€60–120 загалом)

Модель	RAM	Рекомендоване сховище
Raspberry Pi 5 (рекомендовано)	4 ГБ або 8 ГБ	NVMe SSD через M.2 HAT+
Raspberry Pi 4	4 ГБ	USB SSD
Raspberry Pi 3	1 ГБ	більше не підтримується ¹

¹ Raspberry Pi 3 і старіші (32-бітний ARM) більше не підтримуються з v3.51.0: Node.js не публікує образи ARMv7 починаючи з версії 24.

⚠️ Важливо: Не використовуйте SD-карту для постійної роботи. Вона вийде з ладу за кілька місяців під навантаженням записів Tesla Carview. Див. Сховище Raspberry Pi для виправлення за 20 хвилин.

Варіант 2: VPS у хостинг-провайдера

Найкраще для: доступності 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: Отримайте домен, що вказує на ваш сервер

Tesla Carview вимагає HTTPS (Tesla API працює лише через захищені з'єднання). Це означає, що вам потрібен домен з дійсним SSL-сертифікатом.

У мене VPS з фіксованим IP: → Перейдіть до вашого реєстратора доменів і створіть запис A:

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

Зачекайте 5–30 хвилин на розповсюдження DNS, потім продовжуйте.

Я вдома без фіксованого IP: → Див. Доступ через мережу — спочатку налаштуйте DynDNS або Cloudflare Tunnel, потім поверніться сюди.

У мене взагалі немає домену: → Отримайте безкоштовний піддомен на DuckDNS.org (напр. my-tesla.duckdns.org) — це безкоштовно і працює з Let's Encrypt.

---

Крок 3: Запустіть скрипт налаштування

Ця одна команда завантажує та запускає інтерактивного майстра налаштувань:

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)

Скрипт запитує режим розгортання перед тим, як щось робити:

Режим	Коли використовувати
1 — Direct	Виділена VM або VPS без наявного проксі — nginx + certbot встановлюються та налаштовуються автоматично
2 — Proxy	Вже запущений nginx, Caddy, Traefik або налаштування WireGuard+VPS — встановлення nginx повністю пропускається

У режимі Proxy додайте це до вашої наявної конфігурації проксі:

proxy_pass http://127.0.0.1:8080;

Потім скрипт автоматично (режим Direct):

1. Встановлює Docker, nginx, certbot, fail2ban
2. Отримує SSL-сертифікат Let's Encrypt для вашого домену
3. Налаштовує nginx з заголовками безпеки
4. Запускає всі Docker-контейнери
5. Налаштовує базу даних

Це займає 5–10 хвилин.

---

Крок 4: Перший вхід

Відкрийте ваш браузер і перейдіть на https://tesla.yourdomain.com

Ви маєте побачити сторінку входу Tesla Carview. Введіть ім'я користувача та пароль адміна, які ви встановили в Кроці 3.

💡 Підказка: Поставте галочку "Stay signed in (90 days)" на сторінці входу, щоб не доводилося вводити пароль щоразу — особливо корисно при доступі з браузера Tesla.

---

Крок 5: Підключіть ваш обліковий запис Tesla

Після входу ви побачите підказку налаштування для підключення вашого облікового запису Tesla. Дотримуйтесь інструкцій у Налаштування Tesla API.

---

Крок 6: Готово!

Ваша інсталяція Tesla Carview працює. Застосунок почне опитувати дані вашого автомобіля автоматично.

Що робити далі:

• Налаштуйте ваш автомобіль → Dashboard → Add Vehicle
• Налаштуйте сповіщення → Settings → Push Notifications
• Запросіть членів родини → Admin → Users → Invite
• Налаштуйте локацію заряджання → Settings → Charging Locations

---

Оновлення

Tesla Carview може оновлюватися автоматично. Увімкніть це в налаштуваннях:

# У /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" при запуску скрипту → Переконайтеся, що ви запускаєте як root. Запустіть спочатку sudo su.

"Domain not found" під час certbot → Ваш DNS ще не розповсюдився. Зачекайте 10–30 хвилин і спробуйте знову. Перевірте за допомогою: nslookup tesla.yourdomain.com

Контейнери не запускаються → Перевірте журнали: docker compose -f /opt/tesla-carview/docker-compose.prod.yml logs

Більше допомоги → Усунення несправностей | Відкрити Issue

---

Windows-ПК замість сервера (від v3.53.0)

Застосунок повністю працює в Linux-контейнерах — Windows лише хост. З Docker Desktop у режимі WSL2 запускається той самий стек. Скрипт 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 потребує Linux bind-mount і фіксованого UID), а хто все ж запускає проксі, має задати TESLA_PROXY_BASE — у Docker Desktop host.docker.internal вказує на шлюз хоста, а не на контейнер проксі. Усе, що на читання, працює повністю.

Windows не перевіряється в CI. Повний опис: docs/02-deployment.uk.md, розділ «Windows (Docker Desktop)».