diff --git a/docs/SSH_FIX_STEP_BY_STEP.md b/docs/SSH_FIX_STEP_BY_STEP.md new file mode 100644 index 0000000..7b4a77f --- /dev/null +++ b/docs/SSH_FIX_STEP_BY_STEP.md @@ -0,0 +1,196 @@ +# SSH - Diagnostyka i naprawa krok po kroku + +**Data:** 2026-02-05 00:03 +**Problem:** Connection refused na porcie 22 + +--- + +## 🔍 KROK 1: Sprawdź czy addon jest zainstalowany + +1. Otwórz: **http://192.168.50.151:8123** +2. Login: **WK** / Hasło: **QWer!@34** +3. **Settings** → **Add-ons** + +### Pytanie: Czy widzisz addon "Terminal & SSH" na liście? + +**A) TAK - widzę addon na liście:** +- Przejdź do KROKU 2 + +**B) NIE - nie ma addona na liście:** +- Przejdź do KROKU 1B (instalacja) + +--- + +## KROK 1B: Instalacja addona (jeśli brak) + +1. W **Add-ons** kliknij **ADD-ON STORE** (prawy dolny róg) +2. Znajdź **Terminal & SSH** (Official add-ons) +3. Kliknij na addon +4. Kliknij **INSTALL** +5. Poczekaj 1-2 minuty +6. Po instalacji przejdź do KROKU 2 + +--- + +## 🔧 KROK 2: Sprawdź status addona + +Po kliknięciu na addon **Terminal & SSH** zobaczysz górę strony: + +### Pytanie: Jaki jest status? + +**A) RUNNING (zielony):** +- Addon działa, ale coś jest nie tak z portem +- Przejdź do KROKU 3 + +**B) STOPPED (czerwony/szary):** +- Addon nie jest uruchomiony +- Przejdź do KROKU 2B (start) + +**C) ERROR / CRASHED:** +- Addon ma błąd +- Przejdź do KROKU 4 (logi) + +--- + +## KROK 2B: Uruchom addon + +1. W addonie kliknij zakładkę **Info** +2. Włącz przełącznik **Start on boot** (aby startował automatycznie) +3. Włącz przełącznik **Watchdog** (automatyczny restart przy błędzie) +4. Kliknij duży przycisk **START** +5. Poczekaj 20-30 sekund +6. **Sprawdź status** - powinien zmienić się na RUNNING + +### Test połączenia: +```bash +ssh root@192.168.50.151 +# Hasło: QWer!@34 +``` + +### Czy działa? +- **TAK:** ✅ Problem rozwiązany! +- **NIE:** Przejdź do KROKU 3 + +--- + +## 🔍 KROK 3: Sprawdź konfigurację portu + +1. W addonie kliknij zakładkę **Configuration** +2. Sprawdź konfigurację SSH + +### Pytanie: Jaka jest konfiguracja? + +Powinna wyglądać tak: +```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 +``` + +### Jeśli NIE MA hasła: + +1. Dodaj: + ```yaml + ssh: + username: hassio + password: QWer!@34 + ``` +2. Kliknij **SAVE** +3. Zakładka **Info** → **RESTART** +4. Poczekaj 20 sekund +5. Test: `ssh root@192.168.50.151` + +### Jeśli jest inny PORT (np. 22222): + +Test: +```bash +ssh -p 22222 root@192.168.50.151 +``` + +--- + +## 📋 KROK 4: Sprawdź logi addona + +1. W addonie kliknij zakładkę **Log** +2. Prześlij mi **ostatnie 20-30 linii** + +### Częste błędy: + +**"Address already in use":** +- Port 22 jest zajęty przez inny proces +- Rozwiązanie: Zmień port na 22222 + +**"Permission denied":** +- Problem z uprawnieniami +- Rozwiązanie: Reinstall addona + +**"Failed to start sshd":** +- Błąd konfiguracji +- Rozwiązanie: Sprawdź składnię w Configuration + +--- + +## 🔧 KROK 5: Zaawansowana diagnostyka (przez Proxmox) + +Jeśli wszystko inne zawiedzie, możemy sprawdzić bezpośrednio w VM: + +### A) Sprawdź czy VM ma dostęp do sieci: + +```bash +# Na Proxmox host: +qm list +# Znajdź ID dla ha test (prawdopodobnie 100) + +# Wejdź do konsoli VM: +qm terminal 100 +``` + +### B) W konsoli VM sprawdź: + +```bash +# Sprawdź czy SSH addon istnieje +ha addons | grep -i ssh + +# Sprawdź info o addonie +ha addons info core_ssh + +# Sprawdź logi +ha addons logs core_ssh + +# Spróbuj uruchomić +ha addons start core_ssh + +# Sprawdź czy port 22 jest nasłuchiwany +netstat -tuln | grep :22 +``` + +--- + +## 🎯 Co mi powiedz: + +Zrób po kolei kroki i powiedz mi: + +1. **Czy addon jest zainstalowany?** (TAK/NIE) +2. **Jaki jest status?** (RUNNING/STOPPED/ERROR) +3. **Czy jest hasło w konfiguracji?** (TAK/NIE) +4. **Co pokazują logi?** (skopiuj kilka ostatnich linii) + +--- + +## 🚀 Plan naprawy: + +Po uzyskaniu tych informacji: +- ✅ Naprawię konfigurację +- ✅ Uruchomię addon poprawnie +- ✅ Otworzę port SSH +- ✅ Zainstaluję Solcast przez SSH + +--- + +**Czekam na informacje z HA!** 📊 diff --git a/docs/SSH_FIX_STEP_BY_STEP.md b/docs/SSH_FIX_STEP_BY_STEP.md new file mode 100644 index 0000000..7b4a77f --- /dev/null +++ b/docs/SSH_FIX_STEP_BY_STEP.md @@ -0,0 +1,196 @@ +# SSH - Diagnostyka i naprawa krok po kroku + +**Data:** 2026-02-05 00:03 +**Problem:** Connection refused na porcie 22 + +--- + +## 🔍 KROK 1: Sprawdź czy addon jest zainstalowany + +1. Otwórz: **http://192.168.50.151:8123** +2. Login: **WK** / Hasło: **QWer!@34** +3. **Settings** → **Add-ons** + +### Pytanie: Czy widzisz addon "Terminal & SSH" na liście? + +**A) TAK - widzę addon na liście:** +- Przejdź do KROKU 2 + +**B) NIE - nie ma addona na liście:** +- Przejdź do KROKU 1B (instalacja) + +--- + +## KROK 1B: Instalacja addona (jeśli brak) + +1. W **Add-ons** kliknij **ADD-ON STORE** (prawy dolny róg) +2. Znajdź **Terminal & SSH** (Official add-ons) +3. Kliknij na addon +4. Kliknij **INSTALL** +5. Poczekaj 1-2 minuty +6. Po instalacji przejdź do KROKU 2 + +--- + +## 🔧 KROK 2: Sprawdź status addona + +Po kliknięciu na addon **Terminal & SSH** zobaczysz górę strony: + +### Pytanie: Jaki jest status? + +**A) RUNNING (zielony):** +- Addon działa, ale coś jest nie tak z portem +- Przejdź do KROKU 3 + +**B) STOPPED (czerwony/szary):** +- Addon nie jest uruchomiony +- Przejdź do KROKU 2B (start) + +**C) ERROR / CRASHED:** +- Addon ma błąd +- Przejdź do KROKU 4 (logi) + +--- + +## KROK 2B: Uruchom addon + +1. W addonie kliknij zakładkę **Info** +2. Włącz przełącznik **Start on boot** (aby startował automatycznie) +3. Włącz przełącznik **Watchdog** (automatyczny restart przy błędzie) +4. Kliknij duży przycisk **START** +5. Poczekaj 20-30 sekund +6. **Sprawdź status** - powinien zmienić się na RUNNING + +### Test połączenia: +```bash +ssh root@192.168.50.151 +# Hasło: QWer!@34 +``` + +### Czy działa? +- **TAK:** ✅ Problem rozwiązany! +- **NIE:** Przejdź do KROKU 3 + +--- + +## 🔍 KROK 3: Sprawdź konfigurację portu + +1. W addonie kliknij zakładkę **Configuration** +2. Sprawdź konfigurację SSH + +### Pytanie: Jaka jest konfiguracja? + +Powinna wyglądać tak: +```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 +``` + +### Jeśli NIE MA hasła: + +1. Dodaj: + ```yaml + ssh: + username: hassio + password: QWer!@34 + ``` +2. Kliknij **SAVE** +3. Zakładka **Info** → **RESTART** +4. Poczekaj 20 sekund +5. Test: `ssh root@192.168.50.151` + +### Jeśli jest inny PORT (np. 22222): + +Test: +```bash +ssh -p 22222 root@192.168.50.151 +``` + +--- + +## 📋 KROK 4: Sprawdź logi addona + +1. W addonie kliknij zakładkę **Log** +2. Prześlij mi **ostatnie 20-30 linii** + +### Częste błędy: + +**"Address already in use":** +- Port 22 jest zajęty przez inny proces +- Rozwiązanie: Zmień port na 22222 + +**"Permission denied":** +- Problem z uprawnieniami +- Rozwiązanie: Reinstall addona + +**"Failed to start sshd":** +- Błąd konfiguracji +- Rozwiązanie: Sprawdź składnię w Configuration + +--- + +## 🔧 KROK 5: Zaawansowana diagnostyka (przez Proxmox) + +Jeśli wszystko inne zawiedzie, możemy sprawdzić bezpośrednio w VM: + +### A) Sprawdź czy VM ma dostęp do sieci: + +```bash +# Na Proxmox host: +qm list +# Znajdź ID dla ha test (prawdopodobnie 100) + +# Wejdź do konsoli VM: +qm terminal 100 +``` + +### B) W konsoli VM sprawdź: + +```bash +# Sprawdź czy SSH addon istnieje +ha addons | grep -i ssh + +# Sprawdź info o addonie +ha addons info core_ssh + +# Sprawdź logi +ha addons logs core_ssh + +# Spróbuj uruchomić +ha addons start core_ssh + +# Sprawdź czy port 22 jest nasłuchiwany +netstat -tuln | grep :22 +``` + +--- + +## 🎯 Co mi powiedz: + +Zrób po kolei kroki i powiedz mi: + +1. **Czy addon jest zainstalowany?** (TAK/NIE) +2. **Jaki jest status?** (RUNNING/STOPPED/ERROR) +3. **Czy jest hasło w konfiguracji?** (TAK/NIE) +4. **Co pokazują logi?** (skopiuj kilka ostatnich linii) + +--- + +## 🚀 Plan naprawy: + +Po uzyskaniu tych informacji: +- ✅ Naprawię konfigurację +- ✅ Uruchomię addon poprawnie +- ✅ Otworzę port SSH +- ✅ Zainstaluję Solcast przez SSH + +--- + +**Czekam na informacje z HA!** 📊 diff --git a/docs/SSH_TROUBLESHOOTING.md b/docs/SSH_TROUBLESHOOTING.md new file mode 100644 index 0000000..7f1a0e0 --- /dev/null +++ b/docs/SSH_TROUBLESHOOTING.md @@ -0,0 +1,149 @@ +# SSH Troubleshooting - Connection Refused + +**Data:** 2026-02-05 00:01 +**Problem:** `ssh: connect to host 192.168.50.151 port 22: Connection refused` +**Status:** Port 22 zamknięty, port 8123 (HA UI) działa ✅ + +--- + +## Diagnoza: + +✅ **Home Assistant działa** (port 8123 otwarty) +❌ **SSH addon NIE DZIAŁA** (port 22 zamknięty) +❌ **Port 22222 też zamknięty** + +--- + +## Możliwe przyczyny: + +### 1. Addon nie został uruchomiony (START) +Po instalacji addon trzeba **ręcznie uruchomić!** + +### 2. Addon się nie uruchomił (błąd) +Mogą być problemy z konfiguracją + +### 3. Addon używa innego portu +Domyślnie może być 22222 zamiast 22 + +--- + +## Co zrobić? ✅ + +### Krok 1: Sprawdź status addona w HA + +1. Otwórz: http://192.168.50.151:8123 +2. **Settings** → **Add-ons** +3. Kliknij na **Terminal & SSH** +4. Sprawdź status - powinno być **RUNNING** (zielone) + +### Krok 2: Jeśli status NIE JEST "Running": + +**A) Jeśli pokazuje STOPPED:** +- Kliknij **START** +- Poczekaj 20-30 sekund + +**B) Jeśli pokazuje błąd:** +- Przejdź do zakładki **Log** +- Skopiuj błąd i daj mi znać + +**C) Jeśli nie ma addona:** +- Addon nie został zainstalowany +- Wróć do kroku instalacji + +### Krok 3: Sprawdź port w konfiguracji + +1. W addonie przejdź do **Configuration** +2. Sprawdź czy jest ustawienie `port:` +3. Domyślnie może być: + ```yaml + ssh: + username: hassio + password: QWer!@34 + port: 22 + ``` + +**UWAGA:** Niektóre wersje używają portu **22222**! + +### Krok 4: Sprawdź logi addona + +1. W addonie przejdź do zakładki **Log** +2. Szukaj błędów typu: + - "Address already in use" + - "Permission denied" + - "Failed to start" + +--- + +## Testowanie po uruchomieniu: + +### Test 1: Port 22 (domyślny) +```bash +ssh root@192.168.50.151 +# lub +ssh -p 22 root@192.168.50.151 +``` + +### Test 2: Port 22222 (alternatywny) +```bash +ssh -p 22222 root@192.168.50.151 +``` + +### Test 3: Sprawdź który port jest otwarty +```bash +nc -zv 192.168.50.151 22 +nc -zv 192.168.50.151 22222 +``` + +--- + +## Alternatywa: Użyj terminala w przeglądarce! + +Jeśli SSH nie działa, możesz użyć wbudowanego terminala: + +1. **Settings** → **Add-ons** → **Terminal & SSH** +2. Kliknij zakładkę **OPEN WEB UI** (góra) +3. Terminal otworzy się w przeglądarce! +4. Masz dostęp do tego samego shell jak przez SSH + +**Zalety:** +- Działa od razu (nie wymaga SSH) +- Ten sam dostęp co SSH +- Możesz instalować integracje + +**Komendy w terminalu przeglądarki:** +```bash +# Sprawdź system +ls -la /config +ls -la /config/custom_components + +# Zainstaluj Solcast +cd /tmp +wget https://github.com/BJReplay/ha-solcast-solar/archive/refs/heads/main.zip +unzip main.zip +mkdir -p /config/custom_components +cp -r ha-solcast-solar-main/custom_components/solcast_solar /config/custom_components/ +ha core restart +``` + +--- + +## Szybkie rozwiązanie: Terminal w przeglądarce! + +**NIE MUSISZ URUCHAMIAĆ SSH!** 🎉 + +1. Settings → Add-ons → Terminal & SSH +2. Kliknij **OPEN WEB UI** +3. Daj mi znać jak jesteś w terminalu +4. Podam komendy do instalacji Solcast + +--- + +## Status: + +- ⏳ Czekam na informację co pokazuje addon +- 🎯 **ALTERNATYWA:** Użyj terminala w przeglądarce (OPEN WEB UI) +- ✅ Mogę zainstalować Solcast przez terminal przeglądarki! + +--- + +**Najlepsze rozwiązanie:** Terminal w przeglądarce - działa od razu! 🚀