diff --git a/docs/HA_SSH_ACTIVATION_GUIDE.md b/docs/HA_SSH_ACTIVATION_GUIDE.md new file mode 100644 index 0000000..3452866 --- /dev/null +++ b/docs/HA_SSH_ACTIVATION_GUIDE.md @@ -0,0 +1,263 @@ +# Jak aktywować SSH na Home Assistant + +**Data:** 2026-02-05 +**Dotyczy:** HA TEST (192.168.50.151) i HA PROD (192.168.50.242) + +--- + +## Metoda 1: Terminal & SSH addon (ZALECANE) + +### Krok 1: Zaloguj się do Home Assistant +- **TEST:** http://192.168.50.151:8123 +- **PROD:** http://192.168.50.242:8123 +- Login: **WK** +- Hasło: **QWer!@34** + +### Krok 2: Otwórz Add-on Store +1. W menu po lewej kliknij **Settings** (Ustawienia) +2. Kliknij **Add-ons** +3. Kliknij **ADD-ON STORE** (prawy dolny róg) + +### Krok 3: Znajdź SSH addon +1. Wyszukaj: **Terminal & SSH** +2. Lub znajdź w kategorii **Official add-ons** +3. Kliknij na **Terminal & SSH** + +### Krok 4: Zainstaluj addon +1. Kliknij **INSTALL** +2. Poczekaj 1-2 minuty (addon się pobierze i zainstaluje) + +### Krok 5: Skonfiguruj SSH +1. Po instalacji przejdź do zakładki **Configuration** +2. W sekcji **password:** wprowadź hasło SSH +3. **ZALECANE HASŁO:** `QWer!@34` (to samo co do HA) +4. Przykładowa konfiguracja: + +```yaml +ssh: + username: hassio + password: QWer!@34 + authorized_keys: [] + sftp: false + compatibility_mode: false + allow_agent_forwarding: false + allow_remote_port_forwarding: false + allow_tcp_forwarding: false +``` + +5. Kliknij **SAVE** (Zapisz) + +### Krok 6: Uruchom SSH +1. Przejdź do zakładki **Info** +2. Włącz opcję **Start on boot** (Start przy bootowaniu) +3. Włącz opcję **Watchdog** (Auto-restart jeśli się zawiesza) +4. Kliknij **START** +5. Poczekaj 10-20 sekund + +### Krok 7: Sprawdź czy działa +Status powinien pokazywać **RUNNING** (zielony) + +--- + +## Testowanie połączenia SSH + +### Z systemu Linux/Mac: + +```bash +# TEST +ssh -p 22 root@192.168.50.151 +# Hasło: QWer!@34 + +# PROD +ssh -p 22 root@192.168.50.242 +# Hasło: QWer!@34 +``` + +### Z Windows (PowerShell): + +```powershell +ssh -p 22 root@192.168.50.151 +``` + +### Po zalogowaniu: + +```bash +# Sprawdź katalogi HA +ls -la /config +ls -la /config/custom_components + +# Sprawdź wersję HA +ha core info + +# Zobacz logi +ha core logs +``` + +--- + +## Przydatne ścieżki w HAOS przez SSH + +- `/config/` - Główny katalog konfiguracji +- `/config/configuration.yaml` - Główny plik konfiguracyjny +- `/config/automations.yaml` - Automatyzacje +- `/config/scripts.yaml` - Skrypty +- `/config/custom_components/` - Własne integracje (HACS) +- `/config/.storage/` - Pliki systemowe (config_entries, auth, etc.) +- `/share/` - Współdzielony katalog (backupy, etc.) +- `/backup/` - Backupy HA +- `/ssl/` - Certyfikaty SSL + +--- + +## Przydatne komendy przez SSH + +### Zarządzanie Home Assistant: +```bash +ha core info # Info o wersji HA +ha core logs # Logi HA +ha core restart # Restart HA Core +ha core rebuild # Przebuduj HA Core +ha core update # Update HA + +ha supervisor info # Info o Supervisor +ha supervisor logs # Logi Supervisor +ha supervisor restart # Restart Supervisor +``` + +### Zarządzanie addonami: +```bash +ha addons # Lista addonów +ha addons logs # Logi addona +ha addons restart # Restart addona +ha addons start # Start addona +ha addons stop # Stop addona +``` + +### Zarządzanie hostem: +```bash +ha host reboot # Reboot całej maszyny +ha host shutdown # Wyłącz maszynę +ha host info # Info o hoście +``` + +### System: +```bash +df -h # Dyski +free -h # RAM +top # Procesy +journalctl -f # Logi systemowe +``` + +--- + +## Instalacja custom_components przez SSH + +Po aktywacji SSH możesz instalować integracje bez montowania dysków! + +### Przykład - instalacja Solcast: + +```bash +# Zaloguj się przez SSH +ssh root@192.168.50.151 + +# Pobierz integrację +cd /tmp +wget https://github.com/BJReplay/ha-solcast-solar/archive/refs/heads/main.zip +unzip main.zip + +# Skopiuj do custom_components +mkdir -p /config/custom_components +cp -r ha-solcast-solar-main/custom_components/solcast_solar /config/custom_components/ + +# Sprawdź +ls -la /config/custom_components/solcast_solar + +# Posprzątaj +rm -rf /tmp/main.zip /tmp/ha-solcast-solar-main + +# Restart HA +ha core restart +``` + +--- + +## Bezpieczeństwo + +### ⚠️ WAŻNE UWAGI: + +1. **SSH addon daje dostęp root do całego systemu!** +2. **Używaj silnych haseł!** +3. **Opcjonalnie: Dodaj klucze SSH zamiast hasła** +4. **Nie wystawiaj portu 22 na internet!** +5. **SSH tylko z lokalnej sieci (192.168.50.x)** + +### Rekomendowane ustawienia: + +```yaml +ssh: + username: hassio + password: QWer!@34 + authorized_keys: [] + sftp: false + compatibility_mode: false + allow_agent_forwarding: false + allow_remote_port_forwarding: false + allow_tcp_forwarding: false +``` + +--- + +## Alternatywa: File Editor addon + +Jeśli chcesz tylko edytować pliki (bez SSH): + +1. Add-on Store → **File editor** +2. Install → Start +3. Przejdź do addon w menu po lewej +4. Edytuj pliki bezpośrednio w przeglądarce + +**Zalety:** +- Łatwiejszy w użyciu +- Bezpieczniejszy (brak dostępu shell) +- Podświetlanie składni + +**Wady:** +- Brak możliwości uruchamiania komend +- Nie można instalować pakietów +- Tylko edycja plików + +--- + +## Troubleshooting + +### Problem: "Connection refused" +**Rozwiązanie:** +- Sprawdź czy addon jest uruchomiony (RUNNING) +- Sprawdź firewall na HA +- Spróbuj restart addona + +### Problem: "Permission denied" +**Rozwiązanie:** +- Sprawdź hasło (case-sensitive!) +- Sprawdź czy hasło jest ustawione w konfiguracji + +### Problem: "Port 22 already in use" +**Rozwiązanie:** +- Zmień port w konfiguracji SSH addon (np. na 22222) +- Podłącz się: `ssh -p 22222 root@192.168.50.151` + +--- + +## Co dalej? + +Po aktywacji SSH: + +1. ✅ Zainstaluj Solcast przez SSH (szybciej niż przez HACS) +2. ✅ Edytuj configuration.yaml bezpośrednio +3. ✅ Dodawaj automatyzacje przez pliki +4. ✅ Debuguj problemy przez logi +5. ✅ Robij backupy przez SSH + +--- + +**Status:** 📝 Instrukcja gotowa - czeka na aktywację przez użytkownika