Newer
Older
homeassistant-infra / docs / QUICKSTART.md
Wojciech Konieczny 24 days ago 5 KB Add Quick Start Guide

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 Githttp://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)

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:

# 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:

    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:
    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

./scripts/create-ha-vm.sh prod

Powtórz Krok 2 dla środowiska PROD (192.168.50.211)

Krok 5: Synchronizuj TEST → PROD

./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

# 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

# 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

# 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:

crontab -e

Dodaj linię (backup codziennie o 2:00):

0 2 * * * cd ~/homeassistant-infra && ./scripts/backup-ha.sh all >> ~/ha-backup.log 2>&1

📊 Monitoring

Status VM

# TEST
ssh root@192.168.50.200 "qm status 210"

# PROD
ssh root@192.168.50.200 "qm status 211"

Logi Home Assistant

# TEST
ssh root@192.168.50.210 "ha core logs"

# PROD
ssh root@192.168.50.211 "ha core logs"

Wykorzystanie zasobów

# Proxmox
ssh root@192.168.50.200 "pvesh get /cluster/resources --type vm"

🆘 Troubleshooting

Problem: VM nie odpowiada

# 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

# 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

# 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ę:

ssh root@192.168.50.200 "qm terminal 210"
# Postępuj według instrukcji HA OS recovery

🎓 Następne kroki

  1. Poznaj Home Assistant:

  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

🎉 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!