Ana içeriğe geç

Home Assistant OS Kurulumu ve HACS Topluluk Mağazası Rehberi

Bu rehber; Home Assistant OS (HAOS) sistem mimarisini, temel servislerin yerleşimini ve Home Assistant ekosisteminin en güçlü bileşeni olan HACS (Home Assistant Community Store) mağazasının sıfırdan kurulumunu adım adım açıklar.

🏗️ 1. HAOS Temel Erişim ve Ağ Mimarisi

Home Assistant OS (HAOS) kurulduktan sonra ağınızda yerel bir IP adresi alır. Sisteme erişim için temel noktalar:

  • Yerel Web Arayüzü: http://<HAOS_YEREL_IP>:8123 (örn: http://192.168.1.100:8123)
  • Observer (Donanım/Çekirdek Tanı Paneli): http://<HAOS_YEREL_IP>:4357
  • SSH & Web Terminal Erişimi: Port 22 veya 22222 üzerinden SSH yetkisi
  • Samba (Dosya Paylaşımı): \\<HAOS_YEREL_IP>\config

🧩 2. HACS (Home Assistant Community Store) Kurulumu

HACS; topluluk tarafından geliştirilen özel temaları, kartları ve resmi entegrasyon havuzunda bulunmayan yüzlerce cihaz bileşenini tek tıkla kurmanızı sağlar.

Adım 1: "Get HACS" Eklentisinin Eklenmesi

  1. Home Assistant sol menüsünden Ayarlar → Eklentiler → Eklenti Mağazası (Add-on Store) yolunu izleyin.
  2. Sağ üst köşedeki üç noktaya (⋮) tıklayıp Depolar (Repositories) seçeneğini seçin.
  3. Açılan kutucuğa resmi HACS eklenti deposu adresini ekleyin: 
    https://github.com/hacs/addons
  4. Mağaza listesini yenileyin, arama çubuğuna "Get HACS" yazın ve çıkan eklentiyi kurun.
  5. Kurulum tamamlandığında Başlat (Start) butonuna basarak eklentiyi çalıştırın.
  6. Log (Günlük) sekmesinden dosya indirme işleminin bittiğini doğruladıktan sonra Home Assistant'ı Yeniden Başlatın (Ayarlar → Sistem → Yeniden Başlat).

Adım 2: HACS Entegrasyonunun Aktifleştirilmesi ve GitHub Yetkilendirmesi

  1. Sistem yeniden açıldıktan sonra Ayarlar → Cihazlar ve Hizmetler → Entegrasyon Ekle butonuna tıklayın.
  2. Arama kutusuna HACS yazın ve seçin.
  3. Açılan bilgilendirme penceresindeki tüm onay kutularını işaretleyip Gönder deyin.
  4. Ekranda beliren 8 haneli benzersiz kodu kopyalayın ve ekrandaki GitHub bağlantısına (https://github.com/login/device) tıklayın.
  5. GitHub hesabınıza giriş yapıp kodu yapıştırın ve Authorize HACS butonuna basarak izin verin.
  6. Home Assistant ekranına geri döndüğünüzde HACS başarıyla sol kenar çubuğuna eklenecektir.

🛠️ 3. Önerilen Temel Eklentiler (Add-ons)

Bir akıllı ev merkezinin kararlı çalışması için kurulması önerilen kritik eklentiler:

  1. Advanced SSH & Web Terminal: Koruma modu kapatıldığında Docker komutları çalıştırmaya ve gelişmiş sistem yönetimine olanak tanır.
  2. File Editor / Studio Code Server: YAML yapılandırma dosyalarını tarayıcı üzerinden konforlu düzenlemek için.
  3. Samba Share: Ağdaki bilgisayarlardan Home Assistant klasörlerine Windows Gezgini / Finder ile erişim sağlar.
  4. Mosquitto broker: Zigbee ve ESPHome cihazları için hafif ve endüstri standardı MQTT sunucusu.

🚨 4. Kriz Yönetimi ve Sorun Giderme Algoritması

Sistem yanıt vermediğinde veya arayüz açılmadığında sırasıyla uygulanacak mantıksal kontrol adımları:

  1. Ağ Kontrolü: Modem/Router arayüzünden cihazın IP alıp almadığını ve ağ kablosunu kontrol edin.
  2. Observer Portu: http://<HAOS_YEREL_IP>:4357 adresini açarak Supervisor ve Core durumunun "Connected" olup olmadığını denetleyin.
  3. CLI Müdahalesi: SSH veya monitör bağlantısı ile terminalden ha core restart veya ha core logs komutlarını çalıştırın.
  4. Güvenli Kip (Safe Mode): YAML hataları sistemi kilitlediyse ha core start --safe-mode ile özel bileşenleri devre dışı bırakarak açın.
  5. Yedekten Geri Yükleme: Kritik arızalarda ha backups restore <slug> ile en son otomatik yedeğe dönün.