# 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 <addon>  # Logi addona
ha addons restart <addon> # Restart addona
ha addons start <addon>   # Start addona
ha addons stop <addon>    # 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