ESPHome Yerel (Local) Derleme ve Dashboard Kurulum Rehberi

ESPHome, Home Assistant ile kusursuz entegre olan ESP8266 ve ESP32 cihazları için yazılım oluşturma aracıdır. Bu rehber; Home Assistant OS eklentisine alternatif olarak, kendi bilgisayarınızda (Linux veya Windows) ESPHome dashboard ve derleyicisini yerel olarak sıfırdan nasıl kuracağınızı anlatır.

🐧 Yöntem 1: Linux (CachyOS / Arch / Ubuntu) Üzerinde Docker ile Kurulum

Bu yöntem, temiz ve izole bir ortam sunar; derleme araçlarını sisteminize dağıtmadan Docker konteyneri içinde çalıştırır.

1. Docker Kurulumu ve Başlatılması

# Arch / CachyOS için:
sudo pacman -S docker

# Ubuntu / Debian için:
# sudo apt update && sudo apt install -y docker.io

# Docker servisini etkinleştirip başlatın:
sudo systemctl enable --now docker

2. ESPHome Konteynerini Başlatma

Yapılandırma dosyalarınızın kalıcı olması için ev dizininizdeki ~/.esphome klasörünü konteynere bağlıyoruz:

sudo docker run -d \
  --name esphome_yerel \
  --restart unless-stopped \
  -p 6052:6052 \
  -v ~/.esphome:/config \
  ghcr.io/esphome/esphome

3. Web Dashboard Arayüzüne Erişim

Tarayıcınızı açarak şu adrese gidin:

http://localhost:6052

🛠️ Linux Yönetim Komutları

Durdurmak için: sudo docker stop esphome_yerel
Yeniden başlatmak için: sudo docker start esphome_yerel

Sistemi tamamen kaldırmak için:

sudo docker rm -f esphome_yerel
sudo docker rmi ghcr.io/esphome/esphome

🪟 Yöntem 2: Windows Üzerinde Python ile Hafif Kurulum

Windows sistemlerde Docker Desktop kurup sistemi yormak yerine, Python ve pip ile ESPHome çalıştırmak en hızlı ve pratik çözümdür.

1. Python Kurulumu

Resmi Python İndirme Sayfasına gidin ve güncel sürümü indirin.
Kurulum ekranında "Add Python to PATH" (Python'ı Ortam Değişkenlerine Ekle) seçeneğini mutlaka işaretleyin.
"Install Now" seçeneğiyle kurulumu tamamlayın.

2. ESPHome Paketinin Yüklenmesi

Windows tuşuna basıp cmd yazarak Komut İstemi'ni açın.
Aşağıdaki komutu çalıştırarak ESPHome'u yükleyin:
```
pip install esphome
```

3. Dashboard'ı Başlatma

Projelerinizi saklamak için Masaüstünde esphome_projelerim adında bir klasör açın.

Komut İstemi ekranından dashboard'ı başlatın:

esphome dashboard %USERPROFILE%\Desktop\esphome_projelerim

4. Arayüze Bağlantı

Tarayıcınızın adres çubuğuna şunu yazın:

http://localhost:6052

(Not: Windows'ta derleme yaparken Komut İstemi penceresi açık kalmalıdır; pencereyi kapattığınızda dashboard durur).