# 🏠 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:
> [!ref](../docker/docker-install.md)

---

## ⚙️ 2. Installation über Docker CLI

Erstelle zuerst den Homebridge-Ordner:

```bash
sudo mkdir -p /opt/homebridge
```

Starte dann den Container:

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

---

## 🧱 3. Installation über Docker Compose

### 1. Ordner erstellen

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

### 2. Docker Compose Datei erstellen

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

Füge folgenden Inhalt ein:

```yaml
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

```bash
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.