Android'de Home Assistant: Kurulum ve Sunucuya Bağlanma

Kerem Aydın·9 Temmuz 2026·⏱3 dk

Home Assistant Companion, Google Play üzerinden yüklenir ve sunucu URL'si girilip yetkilendirme yapıldıktan sonra telefon hemen HA'da bir "cihaz" haline gelir; konum bilgisi, sensör durumlarını iletir ve anlık bildirimler alır. Aşağıda anlaşılır bir adım adım kılavuz ve pratik ayarlar yer almaktadır.

Home Assistant Companion Nedir?

Home Assistant Companion, akıllı telefonu Home Assistant ekosistemine entegre etmek için resmi Android uygulamasıdır. Şunları sağlar:

  • telefonu veri kaynağına dönüştürür (konum, pil şarjı, adım sayısı, Bluetooth);
  • anlık bildirimleri ve widget'ları almanıza ve yönetmenize olanak tanır;
  • HA sunucusuna yerel ve (yapılandırıldığında) uzaktan erişim sağlar.

Uygulama Android 8.0+ ile çalışır ve Android 16'nın güncel özelliklerini (kesin konum, arka plan izinleri) destekler.

Sunucuya ilk bağlantıdan önce uygulamayı telefona yükleyin; bu, cihaz kaydının oluşturulmasını ve token alınmasını hızlandıracaktır.

Kurulum: Adımlar

  1. Google Play'i açın ve "Home Assistant" (Companion) uygulamasını arayın. Uygulamayı yükleyin (~20 MB).
  2. Uygulamayı başlatın. İlk çalıştırmada "URL Gir" seçeneğini seçin ve sunucu adresinizi girin (örneğin, http://homeassistant.local:8123 veya https://your-domain).
  3. İzin istendiğinde şunları verin:
    • Kesin Konum — bölge takibi için.
    • Bildirim gönderme izni — anlık bildirimler için.
    • Arka plan işlemleri/otomatik başlatma izni (Android 16) — arka planda güvenilir çalışma için.
  4. Sunucu kendi imzalı sertifika kullanıyorsa, sertifikayı yükleme seçeneğini kullanın veya ilk bağlantı için geçici olarak HTTP'yi etkinleştirin, ardından HTTPS'ye geçin.

İpucu: Sunucuya isimle erişilemiyorsa, hata ayıklama için yerel IP adresini (örneğin, 192.168.1.50:8123) kullanın.

Sunucuya Bağlanma ve Temel Ayarlar

  1. Yetkilendirme: Uygulamada, tarayıcı WebView içinde HA yetkilendirme ekranı açılacaktır. HA kullanıcı bilgilerini girin ve onaylayın.
  2. Uzun ömürlü token: Manuel entegrasyon için HA'da bir token oluşturun: Ayarlar → Profil → Uzun Ömürlü Tokenler. Genellikle zorunlu değildir, ancak komut dosyaları ve harici entegrasyonlar için faydalıdır.
  3. HA'daki Cihaz: Giriş yaptıktan sonra telefon, "Cihazlar" bölümünde Companion App olarak görünecek ve sensör verileri göndermeye başlayacaktır.
  4. Uygulamadaki Faydalı Ayarlar:
    • Konum: "Kesin Konum"u etkinleştirin ve pil/t hassasiyetine göre güncelleme sıklığını ayarlayın.
    • Sensörler: Otomasyonlar gerekiyorsa ek sensörleri (adımlar, ışık düzeyi) etkinleştirin.
    • Bildirimler: Farklı öncelikler için Android'de bildirim kanallarını yapılandırın.
    • Widget'lar: Komut dosyalarına/sahnelere hızlı erişim için HA widget'ını ana ekrana ekleyin.
  5. Uzaktan Erişim: Güvenli uzaktan erişim için Nabu Casa'yı kullanın veya HTTPS + port yönlendirme/reverse proxy yapılandırın. İnternete şifreleme olmadan HTTP asla açmayın.

HTTPS olmadan genel URL kullanmayın; bu, kimlik bilgilerinin ve kontrol komutlarının ele geçirilmesi riski taşır.

Telefona Dayalı Otomasyon Örnekleri

  • "Ev" bölgesine dönüşte ışıkları açma: Tetikleyici — bölgeye giriş, Eylem — ışık grubunu aç.
  • Telefon pil şarjı <20% ise — bildirim gönderin ve gereksiz enerji tüketen cihazları kapatın.
  • NFC etiketi + Tasker: Etiketin okunması kapı açma senaryosunu başlatır veya gece modunu açar.

Sık Karşılaşılan Hatalar

  • "Sunucu ulaşılabilir değil": Yerel IP'yi, güvenlik duvarını, port doğruluğunu (8123) ve HA'nın çalışıp çalışmadığını kontrol edin.
  • Konum yok: Android'de "Kesin Konum"u etkinleştirin ve arka plan erişimine izin verin.
  • Bildirimler gelmiyor: Uygulama için otomatik başlatma ve arka plan çalışmasına izin verin; Android bildirim kanallarını kontrol edin.
  • HTTPS sorunları: Sertifikanın doğru olduğundan emin olun veya sunucuya güvenilir bir sertifika yükleyin.

SSS

  • Uygulamada token oluşturmak gerekir mi? Token, UI üzerinden normal yetkilendirme için genellikle gerekmez, ancak API erişimi ve entegrasyonlar için faydalıdır.
  • Birden fazla telefon kullanılabilir mi? Evet — her telefon HA'da ayrı bir cihaz olarak görünür; aile üyeleri için bölgeler ve kurallar oluşturun.
  • Takip nedeniyle pil tüketimini nasıl azaltabilirim? Konum güncellemelerini daha seyrek ayarlayın veya enerji tasarrufu için daha az hassas bir moda geçin.

Kurulum ve temel bağlantı ile başlayın — 20–40 dakika içinde cihazlar üzerinde tam kontrole sahip olacak ve ilk faydalı otomasyonlarınızı oluşturabileceksiniz.