HowTo PVE - LXC HomeBridge

[RuckZuck]

Heute möchte ich euch einmal erklären wie ihr für euch den Dienst "HomeBridge" auf Proxmox selbst hosten könnt.

1. Was ist HomeBridge überhaupt und warum brauche ich es?
Homebridge ist eine Open-Source-Software, die es ermöglicht, Smart-Home-Geräte, die nicht nativ mit Apple HomeKit kompatibel sind, dennoch über die Apple Home App zu steuern und zu automatisieren. Im Grunde ist es eine Brücke, die es erlaubt, Geräte verschiedener Hersteller und Standards in HomeKit zu integrieren.

2. Container vorbereiten
Zu allererst wählen wir uns auf der Oberfläche unseres PVE Servers an und klicken mit Rechtsklick auf unseren Server, wählen dort "Erstelle CT".

Vergebt nun eure gewünscht CT-ID (Container ID), gebt dem Container unter "Hostname" den gewünschten Namen (Beispiel: Homebridge oder Homebridge-WOL, Homebridge-Tasmota, etc.).
klickt an, dass es sich um einen unpriviligierten Container handeln soll, Nesting bleibt aktiv.
Nun vergebt ihr noch das gewünschte Passwort für den Container und bestätigt die EIngabe (2. Mal das Passwort eingeben).
Klickt nun auf "Vorwärts".

Nun wählt ihr euer gewünschtes Template für den Container aus.
Ich nutze für meine LXCs allsamt das Ubuntu24.04 Template von Proxmox (müsst ihr natürlich vorher runtergeladen haben).
Klickt nun auf "Vorwärts".

Wählt den Speicherort der "virtuellen Festplatte" (Storage aus), ich belasse es bei local-lvm und gebt anschließend die gewünschte Größe in GB (GiB) ein.
Ich vergebe grundsätzlich mindestens 8GB dafür.
Klickt nun auf "Vorwärts".

Nun müssen wir die Anzahl der CPU-Kerne des Containers vergeben. Für PiHole reichen eigentlich 2 Kerne, ich habe jedoch 8 vergeben das Updates, etc. einfach schneller durchlaufen ;-)
Klickt nun auf "Vorwärts".

Arbeitsspeicher und SWAP reicht theoretisch 2GB (2048MB), ich vergebe aber grundsätzlich mindestens 8GB (8192MB), allein weil mein Server über ausreichend RAM verfügt und ich es hasse wenn Container "langsam" sind.
Klickt nun auf "Vorwärts".

jetzt müssen wir die Netzwerkeinstellungen konfigurieren.
Solange nicht anders nötig (VLAN, VPN-Netz, oder andere Gründe), vergebe ich eine feste IP-Adresse aus meinem Heimnetz.
Tragt dazu bei IPv4/CIDR die gewünschte IP-Adresse ein, als Beispiel 192.168.178.161/24 und die IP-Adresse eures Gateways (im Normalfall euer Router) ein. Hier als Beispiel mal 192.168.178.1. Bei IPv6 könnt ihr DHCP auswählen um automatisch eine IPV6 Adresse von eurem Router zu erhalten wenn ihr denn eine haben wollt.
Klickt nun auf "Vorwärts".

DNS-Einstellungen könnt ihr lassen wie sie sind.
Klickt nun auf "Vorwärts".

Klickt nun die Funktion "Nach erstellen starten" an und dann auf "Abschließen".

Es dauert einen Moment, dann taucht links euer neuer Homebridge-Container auf.
Klickt nun auf den Container und geht in die Konsole.

Gebt nun im Konsolenfenster den Benutzernamen root ein und als nächstes euer beim erstellen des Containers ausgewähltes Passwort.

Als nächstes updaten wir erst einmal den Container mit nachfolgendem Befehl:

apt update && apt-get upgrade -y && apt-get autoremove -y && reboot

3. Homebridge Repository hinzufügen
Meldet euch nach Neustart wieder mit root/Passwort-Kombi an und gebt als nächstes

apt install curl -y && apt install gpg -y

und anschließend fügen wir den Homebridge Repository GPG key hinzu mit

curl -sSfL https://repo.homebridge.io/KEY.gpg | sudo gpg --dearmor | sudo tee /usr/share/keyrings/homebridge.gpg  > /dev/null

Nun fürgen wir das Homebridge Repository zu den system sources hinzu

echo "deb [signed-by=/usr/share/keyrings/homebridge.gpg] https://repo.homebridge.io stable main" | sudo tee /etc/apt/sources.list.d/homebridge.list > /dev/null

4. Homebridge installieren
Nun haben wir die Grundlage geschaffen um Homebridge selbst zu installieren.
Erst updaten wir unsere Sources mittels

apt-get update

und installieren dann Homebridge

apt-get install homebridge -y

5. Einloggen in das WebIF
Ruft nun das WebIF von Homebridge auf mittels der von euch festgelegten IPv4-Adresse eures Containers und Port 8581
192.168.178.160:8581

Klickt als nächstes auf "Los geht's" um eine neue Homebridge einzurichten (oder "Widerherstellen aus Backup" solltet ihr eine bestehende Homebridge auf den Proxmox Server importieren wollen. Da gehe ich hier aber erst einmal nicht drauf ein).

Vergebt nun einen Nutzernamen und Passwort für das WebIF und klickt auf "WEITER" und auf der nächsten Seite nochmal auf "WEITER".

Eure Homebridge ist nun zum Einsatz bereit.

Hinweis:
Ich selbst habe pro Plugin einen eigenen Container mit eigener Homebridge am laufen, da ich in der Vergangenheit oft Probleme mit Homebridge und mehreren Plugins hatte. So können sich Plugins und Geräte nicht gegenseitig stören und im Fehlerfall bleibt halt nur eine Homebridge mit 1-2 Geräten stehen und nicht allen
Dies soll zwar mit Homebridge 2.0 "verbessert" werden, aber nunja. Noch gibt es diese ja nicht ;-)


weitere geplante HowTo's (werde ich dann nach und nach hier verlinken):

• HowTo PVE - Installation von Proxmox Virtual Environment
• HowTo PVE - serielles Gerät an LXC durchreichen
• HowTo PVE - PiHole und AdGuard gleichzeitig in eurer FritzBox nutzen
• HowTo PVE - LXC Whoogle-Search
• HowTo PVE - LXC PiHole
• HowTo PVE - LXC AdGuard
• HowTo PVE - LXC NGinx Proxy Manager inkl. Updaten einer Stato-Domain.
• HowTo PVE - LXC HomeAssistant
• HowTo PVE - LXC Apache2 Webserver
• HowTo PVE - LXC Nextcloud
• HowTo PVE - VM Synology-NAS selbst gebaut mit Proxmox
• HowTo PVE - VM Windows Server 2022
• HowTo PVE - VM Windows Server 2025
• HowTo PVE - VM macOS
• HowTo PBS - Installation von Proxmox Backup Server (WICHTIG!)
• HowTo PBS - Installation von Proxmox Backup Server auf einem Raspberry Pi (für mich erstmal ganz weit hinten, geht aber!)

Wenn euch noch Themen einfallen, meldet euch gern per PN bei mir, dann gucke ich ob und wann ich das ganze selbst ausprobiere und hier als HowTo erstelle wie ich es gelöst habe.