diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md new file mode 100644 index 0000000..a4740d7 --- /dev/null +++ b/docs/QUICKSTART.md @@ -0,0 +1,268 @@ +# Quick Start Guide - Home Assistant Test/Prod + +## 🎯 Cel +Masz teraz kompletne środowisko do pracy z Home Assistant w trybie Infrastructure as Code. + +## ✅ Co już masz + +1. **Repozytorium Git** → http://192.168.50.101:8080/root/homeassistant-infra +2. **Skrypty automatyzacji** → `~/homeassistant-infra/scripts/` +3. **Dokumentacja** → `~/homeassistant-infra/README.md` +4. **Backup system** → Gotowy do użycia + +## 🚀 START - Tworzenie środowisk + +### Krok 1: Utwórz środowisko TEST (5-10 min) + +```bash +cd ~/homeassistant-infra +./scripts/create-ha-vm.sh test +``` + +**Co się dzieje:** +- Pobieranie Home Assistant OS z GitHub +- Tworzenie VM na Proxmox (ID: 210) +- Konfiguracja sieci +- Autostart VM + +**Czekaj ~10-15 minut** na pierwsze uruchomienie. + +Sprawdź status: +```bash +# Opcja 1: Ping +ping -c 3 192.168.50.210 + +# Opcja 2: Sprawdź webUI +curl -s http://192.168.50.210:8123 | head -10 + +# Opcja 3: Watch (automatyczne odświeżanie) +watch -n 5 'curl -s http://192.168.50.210:8123 -o /dev/null && echo "HA READY ✅" || echo "Czekam..."' +``` + +### Krok 2: Pierwsza konfiguracja Home Assistant TEST + +1. **Otwórz przeglądarkę**: http://192.168.50.210:8123 + +2. **Setup Wizard**: + - Utwórz konto administratora + - Ustaw nazwę: "Test Home" + - Lokalizacja: (twoja lokalizacja) + - Pomiń integracje na razie + +3. **Włącz SSH (WAŻNE!):** + ``` + Supervisor → System → Zaawansowane → Terminal & SSH + ``` + - Kliknij "Install" + - Po instalacji → Configuration + - Ustaw hasło: `QWer!@34` + - Zapisz i Start + +4. **Test SSH:** + ```bash + sshpass -p "QWer!@34" ssh root@192.168.50.210 "ha core info" + ``` + +### Krok 3: Dodaj przykładową automatyzację w TEST + +W webUI Home Assistant TEST: + +1. **Settings → Automations & Scenes → Create Automation** +2. **Przykład - Sunrise notification**: + ```yaml + alias: Test Sunrise Notification + trigger: + - platform: sun + event: sunrise + action: + - service: notify.persistent_notification + data: + title: "Good morning!" + message: "The sun is up" + ``` +3. Zapisz + +### Krok 4: Utwórz środowisko PROD + +```bash +./scripts/create-ha-vm.sh prod +``` + +**Powtórz Krok 2** dla środowiska PROD (192.168.50.211) + +### Krok 5: Synchronizuj TEST → PROD + +```bash +./scripts/sync-test-to-prod.sh +``` + +**Co się dzieje:** +1. Backup PROD automatycznie +2. Kopiowanie plików konfiguracyjnych +3. Kopiowanie automatyzacji +4. Restart Home Assistant na PROD + +Sprawdź: http://192.168.50.211:8123 + +## 📝 Codzienny workflow + +### Scenariusz 1: Nowa automatyzacja + +```bash +# 1. Pracuj w TEST +# Otwórz: http://192.168.50.210:8123 +# Dodaj automatyzację w webUI + +# 2. Testuj +# Sprawdź czy działa jak należy + +# 3. Commit (opcjonalnie) +cd ~/homeassistant-infra +git pull +git add . +git commit -m "Added new automation: XYZ" +git push + +# 4. Deploy na PROD +./scripts/sync-test-to-prod.sh +``` + +### Scenariusz 2: Testowanie nowej integracji + +```bash +# 1. Dodaj integrację w TEST +# Settings → Devices & Services → Add Integration + +# 2. Testuj przez kilka dni + +# 3. Jeśli OK → sync na PROD +./scripts/sync-test-to-prod.sh +``` + +### Scenariusz 3: Coś się zepsuło na PROD + +```bash +# 1. Lista backupów +ls -lh ~/homeassistant-infra/backups/ + +# 2. Przywróć ostatni backup +./scripts/restore-backup.sh \ + ~/homeassistant-infra/backups/prod_backup_20260203_220000.tar.gz \ + prod +``` + +## 🔄 Automatyczne backupy + +Dodaj do crontab: + +```bash +crontab -e +``` + +Dodaj linię (backup codziennie o 2:00): +```cron +0 2 * * * cd ~/homeassistant-infra && ./scripts/backup-ha.sh all >> ~/ha-backup.log 2>&1 +``` + +## 📊 Monitoring + +### Status VM + +```bash +# TEST +ssh root@192.168.50.200 "qm status 210" + +# PROD +ssh root@192.168.50.200 "qm status 211" +``` + +### Logi Home Assistant + +```bash +# TEST +ssh root@192.168.50.210 "ha core logs" + +# PROD +ssh root@192.168.50.211 "ha core logs" +``` + +### Wykorzystanie zasobów + +```bash +# Proxmox +ssh root@192.168.50.200 "pvesh get /cluster/resources --type vm" +``` + +## 🆘 Troubleshooting + +### Problem: VM nie odpowiada + +```bash +# Restart VM +ssh root@192.168.50.200 "qm reboot 210" # TEST +ssh root@192.168.50.200 "qm reboot 211" # PROD +``` + +### Problem: Home Assistant nie startuje + +```bash +# Sprawdź logi +ssh root@192.168.50.210 "journalctl -u hassio-supervisor -f" + +# Restart tylko HA (nie całej VM) +ssh root@192.168.50.210 "ha core restart" +``` + +### Problem: Sync nie działa + +```bash +# Sprawdź czy SSH działa +ssh root@192.168.50.210 "hostname" +ssh root@192.168.50.211 "hostname" + +# Sprawdź czy katalog config istnieje +ssh root@192.168.50.210 "ls -la /root/config/" +``` + +### Problem: Zapomniałem hasła do HA + +Musisz zresetować przez konsolę: +```bash +ssh root@192.168.50.200 "qm terminal 210" +# Postępuj według instrukcji HA OS recovery +``` + +## 🎓 Następne kroki + +1. **Poznaj Home Assistant**: + - https://www.home-assistant.io/getting-started/ + - Dodaj pierwsze urządzenia + - Stwórz dashboardy + +2. **Rozbuduj infrastrukturę**: + - Dodaj monitoring (Grafana) + - Webhook do auto-deploy z Git + - Staging environment + +3. **Backup offsite**: + - Kopiuj backupy na zewnętrzny storage + - Cloud backup (Nextcloud, S3) + +## 📚 Przydatne linki + +- **Home Assistant Docs**: https://www.home-assistant.io/docs/ +- **Community**: https://community.home-assistant.io/ +- **Awesome HA**: https://www.awesome-ha.com/ +- **Twój GitBucket**: http://192.168.50.101:8080/root/homeassistant-infra + +## 🎉 Gotowe! + +Masz teraz: +- ✅ Środowisko testowe (192.168.50.210) +- ✅ Środowisko produkcyjne (192.168.50.211) +- ✅ Skrypty do zarządzania +- ✅ System backupów +- ✅ Wersjonowanie w Git +- ✅ Dokumentację + +**Zaczynaj od TEST, testuj, a potem wdrażaj na PROD!**