HAOS (Home Assistant Operating System) CLI Komutları

Komutlar önem ve kullanım sıklığına göre kategorize edilmiştir. Tüm komutlar ha ön ekiyle çalışır.

1. Çekirdek (Core) Komutları (En Sık Kullanılanlar)

YAML düzenlemeleri ve sistem güncellemeleri sonrası öncelikli başvurulan komutlardır.

ha core check: Home Assistant konfigürasyonunu kontrol eder. Cihazı yeniden başlatmadan önce YAML hatalarını tespit etmek için kritiktir.
ha core restart: Sadece Home Assistant çekirdeğini yeniden başlatır. Cihazın tamamını yeniden başlatmaktan çok daha hızlıdır.
ha core update: Home Assistant Core sürümünü günceller.
ha core logs: Home Assistant loglarını ekrana basar. Sorun giderme için temel adımdır.
ha core stop / ha core start: Çekirdek servisini manuel olarak durdurur veya başlatır.

2. Host (Donanım/Sanal Makine) Komutları

İşletim sistemi seviyesindeki müdahaleler için kullanılır.

ha host reboot: Cihazı (Raspberry Pi, Mini PC veya Sanal Makine) fiziksel olarak yeniden başlatır. Ağ kopmaları veya kilitlenmelerde kullanılır.
ha host shutdown: Sistemi güvenli bir şekilde kapatır. Gücü kesmeden önce veri bozulmasını önlemek için zorunludur.
ha host info: IP, disk, işletim sistemi versiyonu gibi donanım ve host bilgilerini listeler.
ha host update: HAOS'un (işletim sisteminin kendisinin) sürümünü günceller.

3. Supervisor Komutları

Docker konteynerlerini, eklentileri ve güncellemeleri yöneten ana bileşenin kontrolleridir.

ha supervisor restart: Supervisor servisini yeniden başlatır. (Sistem yavaşlamalarında veya eklenti yükleme hatalarında işe yarar).
ha supervisor update: Supervisor'ı günceller.
ha supervisor logs: Supervisor loglarını görüntüler.
ha supervisor repair: Dosya sistemi veya izinlerle ilgili Docker seviyesindeki hataları onarmayı dener.

4. Eklenti (Add-on) Komutları

Eklentileri (Mosquitto broker, Node-RED, ESPHome vb.) terminalden yönetmek için kullanılır. İşlem yapmak için eklentinin "slug" (kısa kod) adına ihtiyacınız vardır.

ha addons list: Yüklü eklentileri ve durumlarını (çalışıyor/durdu) listeler. İşlem yapılacak eklentinin slug'ını buradan öğrenebilirsiniz.
ha addons restart [slug]: Belirtilen eklentiyi yeniden başlatır. (Örn: ha addons restart a0d7b954_esphome)
ha addons start [slug]: Kapalı bir eklentiyi başlatır.
ha addons stop [slug]: Çalışan bir eklentiyi durdurur.
ha addons logs [slug]: Sadece o eklentiye ait log kayıtlarını getirir.

5. Yedekleme (Backup) Komutları

ha backups list: Sistemde kayıtlı yedekleri ve ID'lerini (slug) listeler.
ha backups new: Yeni bir tam yedek (full backup) oluşturur. Güncelleme öncesi terminalden manuel tetikleme için idealdir.
ha backups restore [slug]: Belirtilen yedeği geri yükler.

6. Ağ (Network) ve Genel Bilgi Komutları

ha network info: Cihazın ağ arayüzlerini, atanan IP adreslerini ve DNS yapılandırmasını listeler.
ha info: Çekirdek, supervisor ve işletim sisteminin genel durumunu tek çıktıda özetler.
ha resolution info: Sistem tarafından tespit edilen darboğazları veya çözülmesi gereken konfigürasyon sorunlarını listeler.

Not: Herhangi bir komutun alt parametrelerini görmek için komut sonuna --help eklenebilir (Örneğin: ha core update --help).

Linux terminalden bağlanmak için

ssh ali@192.168.1.110