Panoda bir ışık, priz veya sensör gri görünüyor; ayrıntısında durum “Kullanılamıyor” (İngilizce arayüzde unavailable) yazıyor ve kontrol edilemiyor. Bazen tek bir cihaz, bazen bir entegrasyona bağlı tüm cihazlar aynı anda bu duruma düşüyor.
Kısa yanıt#
“Kullanılamıyor”, Home Assistant’ın cihaza veya hizmete o anda ulaşamadığını ya da entegrasyonun kurulamadığını gösterir. Önce sorunun tek cihazda mı yoksa bütün bir entegrasyonda mı olduğunu belirleyin. Tek cihazsa güç, ağ ve IP adresini; tüm entegrasyonsa Ayarlar > Cihazlar ve hizmetler ekranındaki hata mesajını, yeniden yüklemeyi ve gerekiyorsa yeniden kimlik doğrulamayı kontrol edin. Kalıcı çözüm için entegrasyonun hata ayıklama günlüğünü açıp sorunu yeniden üretin.
“Kullanılamıyor” ile “bilinmiyor” farkı#
Home Assistant belgelerine göre iki durum farklı anlamlar taşır:
- Kullanılamıyor (unavailable): Varlık durumunu şu anda bildiremiyor; örneğin cihaza veya hizmete ulaşılamıyor ya da varlığın entegrasyonu kurulmamış.
- Bilinmiyor (unknown): Varlığın durumu için bir değer yok; bağlantı olsa bile henüz veri gelmemiş olabilir.
Varlığın özniteliklerinde restored: true görüyorsanız entegrasyon o varlığı hiç kurmamış (ör. entegrasyon yüklenemedi veya kaldırıldı) demektir; bu durumda sorunu cihazda değil, entegrasyonda arayın. Öznitelikleri Ayarlar > Araçlar > Durumlar (Geliştirici araçları) ekranında görebilirsiniz; menü adı sürüme göre farklılık gösterebilir.
Önce kapsamı belirleyin#
- Tek cihaz kullanılamıyor: Büyük olasılıkla cihazın gücü, Wi-Fi/Zigbee sinyali veya IP adresi değişmiştir.
- Bir entegrasyondaki tüm cihazlar kullanılamıyor: Entegrasyon kurulumu, oturum/token, ağ köprüsü (hub) veya üreticinin bulut hizmeti üzerinde durun.
- Birden fazla entegrasyon aynı anda düştü: Home Assistant sunucusunun ağ bağlantısını, saatini ve son güncellemeyi kontrol edin.
Teşhis sırası#
- Cihaz ve güç: Cihazın elektriği var mı, pil bitmiş mi, kendi uygulamasından kontrol edilebiliyor mu? Duvar anahtarından kapatılan akıllı ampuller ağdan düşer.
- Ağ ve IP adresi: Yerel ağ üzerinden çalışan cihazlarda modem arayüzünden cihazın hâlâ ağda olup olmadığına ve IP adresinin değişip değişmediğine bakın. IP değiştiyse entegrasyonu yeni adresle yeniden yapılandırın ve modemde bu cihaz için DHCP rezervasyonu (sabit IP) tanımlamayı değerlendirin.
- Entegrasyon durumu: Ayarlar > Cihazlar ve hizmetler ekranında ilgili entegrasyon kartında hata, “yeniden deneniyor” veya “kurulum başarısız” uyarısı var mı? Uyarı metni sorunun türünü (bağlantı, kimlik doğrulama, yapılandırma) çoğunlukla söyler.
- Yeniden yükleme: Entegrasyon kartındaki üç nokta menüsünden Yeniden yükle seçeneği, tüm sistemi yeniden başlatmadan entegrasyonu yeniden başlatır. Sorun geçici bir kopmaysa bu yeterli olabilir; ancak sık tekrarlıyorsa asıl nedeni bulmak için günlüğe geçin.
- Kimlik doğrulama: Bulut hesabı kullanan entegrasyonlarda parola değişikliği veya süresi dolan oturum varlıkları düşürebilir. Entegrasyon yeniden kimlik doğrulama veya yeniden yapılandırma isterse kartın yönlendirmesini izleyin.
- Bulut hizmeti ve bilinen sorunlar: Entegrasyon üreticinin bulut sunucusuna bağlıysa hizmetin kendisinde kesinti olabilir. Home Assistant’ın entegrasyon uyarıları sayfası bilinen sorunları duyurur.
- Yapılandırma ve bağımlılıklar: YAML ile yapılandırılan entegrasyonlarda yapılandırma kontrolünü çalıştırın; Home Assistant gerekli bağımlılığı yükleyemezse bu bilgi günlüklerde görünür ve belgeler önce bir yeniden başlatmayı önerir.
Hata ayıklama günlüğü ve tanılama#
Sorun tekrar ediyorsa tahmin yerine kanıtla ilerleyin:
- Ayarlar > Cihazlar ve hizmetler > ilgili entegrasyon > sağ üst üç nokta > Hata ayıklama günlüğünü etkinleştir.
- Sorunu yeniden üretin: cihazı kontrol etmeyi deneyin veya kopmanın gerçekleşmesini bekleyin.
- Aynı menüden Hata ayıklama günlüğünü devre dışı bırak‘ı seçin; Home Assistant günlük dosyasını indirmenizi önerir.
- Entegrasyon destekliyorsa aynı menüden Tanılamayı indir ile tanılama dosyasını da alın.
Hata ayıklama günlüğünü sürekli açık bırakmayın; günlük dosyasını büyütür. Günlük ve tanılama dosyalarını forumda veya GitHub’da paylaşmadan önce içinde e-posta, IP adresi, konum veya token gibi kişisel bilgi olup olmadığını kontrol edin.
Sorun güncellemeden sonra başladıysa#
- Sürüm notlarında ilgili entegrasyon için “geriye dönük uyumsuz değişiklik” (breaking change) olup olmadığına bakın.
- Geri dönmeyi düşünüyorsanız önce güncel bir yedeğiniz olduğundan emin olun: Home Assistant yedeği nasıl güvenle saklanır?
- Sistem beklenmedik şekilde yeniden başlıyor veya donuyorsa Home Assistant belgeleri,
configuration.yamldosyasına geçici olarakhomeassistant: debug: trueeklenerek sorunlu entegrasyonun tespit edilebileceğini belirtiyor. Bu ayar küçük bir performans maliyeti getirir; uzun süre açık bırakılması önerilmez.
Otomasyonları koruma#
Bir varlık kısa süre kullanılamaz duruma düşüp geri geldiğinde, durum değişikliği tetikleyicisi beklenmedik biçimde çalışabilir. Önemli otomasyonlarda (ör. kombi, kapı kilidi) tetikleyicinin “kullanılamıyor” durumundan dönüşte devreye girmemesine dikkat edin; otomasyon izleriyle neyin tetiklendiğini kontrol edebilirsiniz: Home Assistant otomasyonu çalışmıyor: İzlerle teşhis.
Kapsam#
Home Assistant OS, Container ve Supervised kurulumları; bu kontrol sırasında belgelenen sürüm 2026.10.2’dir. Menü adları sürüme ve dil ayarına göre farklılık gösterebilir. Zigbee, Z-Wave, Matter ve ESPHome gibi protokollerin her birinin kendi ek teşhis ekranları vardır; bu rehber genel sırayı verir. Zigbee (ZHA) cihazları için mesh, parazit ve kanal teşhisi 09.10 paketindeki ayrı taslakta ele alınmıştır.
Sık sorulan sorular#
Her gün aynı saatte cihazlar kullanılamaz oluyor, neden?
Planlı bir yeniden başlatma, modemin gece bakımı, DHCP kira süresinin dolması veya bulut hizmetinin bakım zamanı olabilir. Kopma saatini hata ayıklama günlüğüyle eşleştirmek nedeni gösterir.
“Yeniden yükle” sorunu çözüyor; bunu otomasyona bağlasam olur mu?
Geçici bir önlem olarak işe yarayabilir ama asıl nedeni gizler. Önce günlükle kök nedeni bulun; sorun entegrasyondaysa hata ayıklama günlüğü ve tanılama dosyasıyla rapor edin.
Kullanılamayan varlığı silmeli miyim?
Cihaz hâlâ evdeyse silmeyin; geçmiş verisi ve otomasyon bağlantıları kaybolabilir. Yalnızca cihazı gerçekten kaldırdıysanız ve entegrasyon artık o varlığı sağlamıyorsa silin.
İlginizi çekebilir
Home Assistant otomasyonu çalışmıyor
Home Assistant yedek acil durum kiti
Home Assistant enerji sensörü görünmüyor
Kaynaklar#
• Home Assistant Belgeleri — State and state object
• Home Assistant Belgeleri — Troubleshooting your configuration
• Home Assistant Geliştirici Belgeleri — Mark entity unavailable if appropriate
