- Registriert
- 8. November 2012
- Beiträge
- 2.095
- Lösungen
- 3
- Reaktionspunkte
- 2.459
- Punkte
- 2.130
- Ort
- World Wide Web
Heute möchte ich euch erklären wie ihr euren eigenen Ubiquiti UniFi-Controller auf einem Proxmox-Server als LXC hosten könnt ;-)
1. Was ist UniFi.Controller überhaupt und warum brauche ich es?
Der UniFi Controller ist eine kostenlose Software von Ubiquiti, die als zentrale Verwaltung für das UniFi-Netzwerk dient. Er ermöglicht das Einrichten, Konfigurieren, Verwalten und Überwachen von UniFi-Geräten wie Access Points, Switches und Gateways über eine einzige, intuitive Weboberfläche. Der Controller kann auf eigener Hardware (PCs, Macs, Linux) oder als Cloud-Dienst betrieben werden und bietet eine umfassende Kontrolle über das gesamte Netzwerk, inklusive Datenfluss, Sicherheitseinstellungen und Netzwerkstatistiken
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: UniFi oder UniFi-Controller, 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 UniFi-Controller 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.7/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 HomeAssistant-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:
3. UniFi-Controller installieren
Meldet euch nach Neustart wieder mit root/Passwort-Kombi an und gebt als nächstes
ein um die für das Installtionsskript nötigen Pakete zu installieren, anschließend dann
um das Installationsskript runterzuladen und auszuführen.
Nach einiger Zeit werden wir gefragt, ob wir Fehlerdateien an die Entwickler senden wollen.
Das dürft ihr gern selbst entscheiden und beantwortet die Frage mit "n" für no/nein oder "y" für yes/ja.
Die restlichen Fragen nach erhalt des Installtionsskripts, updates via APT können wir getrost mit "y" yes/ja beantworten.
4. Erstes Anmelden im WebIF des UniFi-Controllers
Gebt nun im Browser eurer Wahl die IP-Adresse eures Containers ein, gefolgt von Port 8443, in unserem Beispiel also
Meldet euch mit eurem Ubiquiti-Account an oder erstellt euch einen.
FERTIG
Der Rest sollte (sofern man mit der Materie schon einigermaßen vertraut ist) selbsterklärend sein. Darauf gehe ich hier nicht weiter ein.
weitere geplante HowTo's (werde ich dann nach und nach hier verlinken):
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.
1. Was ist UniFi.Controller überhaupt und warum brauche ich es?
Der UniFi Controller ist eine kostenlose Software von Ubiquiti, die als zentrale Verwaltung für das UniFi-Netzwerk dient. Er ermöglicht das Einrichten, Konfigurieren, Verwalten und Überwachen von UniFi-Geräten wie Access Points, Switches und Gateways über eine einzige, intuitive Weboberfläche. Der Controller kann auf eigener Hardware (PCs, Macs, Linux) oder als Cloud-Dienst betrieben werden und bietet eine umfassende Kontrolle über das gesamte Netzwerk, inklusive Datenfluss, Sicherheitseinstellungen und Netzwerkstatistiken
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: UniFi oder UniFi-Controller, 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 UniFi-Controller 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.7/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 HomeAssistant-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:
Code:
apt-get update && apt-get upgrade -y && apt-get autoremove -y && reboot
3. UniFi-Controller installieren
Meldet euch nach Neustart wieder mit root/Passwort-Kombi an und gebt als nächstes
Code:
apt-get install ca-certificates curl -y
Code:
curl -sO https://get.glennr.nl/unifi/install/install_latest/unifi-latest.sh && bash unifi-latest.sh
Nach einiger Zeit werden wir gefragt, ob wir Fehlerdateien an die Entwickler senden wollen.
Das dürft ihr gern selbst entscheiden und beantwortet die Frage mit "n" für no/nein oder "y" für yes/ja.
Die restlichen Fragen nach erhalt des Installtionsskripts, updates via APT können wir getrost mit "y" yes/ja beantworten.
4. Erstes Anmelden im WebIF des UniFi-Controllers
Gebt nun im Browser eurer Wahl die IP-Adresse eures Containers ein, gefolgt von Port 8443, in unserem Beispiel also
Sie müssen registriert sein, um Links zu sehen.
Meldet euch mit eurem Ubiquiti-Account an oder erstellt euch einen.
FERTIG

Der Rest sollte (sofern man mit der Materie schon einigermaßen vertraut ist) selbsterklärend sein. Darauf gehe ich hier nicht weiter ein.
weitere geplante HowTo's (werde ich dann nach und nach hier verlinken):
- HowTo PVE - serielles Gerät an LXC durchreichen
- HowTo PVE - PiHole und AdGuard gleichzeitig in eurer FritzBox nutzen
- HowTo PVE - LXC PiHole
- HowTo PVE - LXC AdGuard
- HowTo PVE - LXC Whoogle-Search
- HowTo PVE - LXC NGinx Proxy Manager inkl. Updaten einer Stato-Domain.
- HowTo PVE - LXC Homebridge
- HowTo PVE - LXC HomeAssistant
- HowTo PVE - LXC Apache2 Webserver
- HowTo PVE - LXC Nextcloud
- HowTo PVE - LXC IPC 11.6 mit OSCam
- HowTo PVE - LXC S3 Simplebuild mit FTP/SCP Zugriff
- HowTo PVE - VM Synology-NAS selbst gebaut mit Proxmox
- HowTo PVE - VM MS Dos 6.22
- HowTo PVE - VM Windows 3.11
- HowTo PVE - VM Windows 95
- HowTo PVE - VM Windows 98 SE
- HowTo PVE - VM Windows 2000 professional
- HowTo PVE - VM Windows ME
- HowTo PVE - VM Windows XPpro
- HowTo PVE - VM Windows 10
- HowTo PVE - VM Windows 11
- HowTo PVE - VM Windows Server 2022
- HowTo PVE - VM Windows Server 2025
- HowTo PVE - VM macOS
- HowTo PVE - VM AndroidOS
- 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.
Zuletzt bearbeitet: