# 🏠 Homebridge in Docker installieren

Diese Anleitung zeigt, wie du Homebridge in einem Docker-Container betreibst — entweder über die Docker CLI oder mit Docker Compose.

# 🐳 1. Docker installieren

📦 Wenn Docker noch nicht installiert ist, folge dieser Anleitung:

🐳 Docker & Docker Compose Installation (Debian / Ubuntu)

../../docker/docker-install/

# ⚙️ 2. Installation über Docker CLI

Erstelle zuerst den Homebridge-Ordner:

sudo mkdir -p /opt/homebridge

Starte dann den Container:

docker run -d   --net=host   --name=homebridge   -v /opt/homebridge:/homebridge   homebridge/homebridge:latest

# 🧱 3. Installation über Docker Compose

# 1. Ordner erstellen

sudo mkdir -p /opt/homebridge
cd /opt/homebridge

# 2. Docker Compose Datei erstellen

sudo nano /opt/homebridge/docker-compose.yml

Füge folgenden Inhalt ein:

version: '2'
services:
  homebridge:
    image: homebridge/homebridge:latest
    restart: always
    network_mode: host
    volumes:
      - /opt/homebridge:/homebridge
    logging:
      driver: json-file
      options:
        max-size: '10m'
        max-file: '1'
    healthcheck:
      test: curl --fail localhost:8581 || exit 1
      interval: 60s
      retries: 5
      start_period: 300s
      timeout: 2s

# 3. Container starten

docker compose up -d

# 🌐 4. Zugriff auf das Webinterface

Nach dem Start erreichst du Homebridge im Browser unter:

http://<SERVER-IP>:8581

# 🧰 5. Nützliche Befehle

Befehl	Beschreibung
`docker ps`	Zeigt laufende Container
`docker logs -f homebridge`	Live-Logs von Homebridge
`docker compose restart`	Neustart des Containers
`docker compose down`	Stoppt und entfernt Homebridge

# ✅ 6. Abschluss

Nach der Installation kannst du dich im Homebridge Webinterface anmelden und Plugins für deine Smart-Home-Geräte hinzufügen.