UniFi OS Server selbst hosten

Mit dem UniFi OS Server läuft die UniFi-Verwaltung auf einem eigenen Linux-Server oder einer VM, z. B. bei einem Cloud-Anbieter. Damit lassen sich UniFi-Geräte an mehreren Standorten zentral verwalten, ohne Cloud Key oder Gateway.

1. Installation

Der UniFi OS Server läuft in Containern mit Podman. Auf Debian bzw. Ubuntu:

sudo apt update && sudo apt install podman slirp4netns

Den Installer für die passende Architektur (x64 oder ARM64) von der UniFi-Downloadseite (Bereich Software → UniFi OS Server) herunterladen, ausführbar machen und starten:

curl -O <Download-Link des Installers>
chmod +x <Installer-Datei>
sudo ./<Installer-Datei> install

Der genaue Ablauf steht im Ubiquiti Help Center unter „Self-Hosting UniFi“. Nach der Installation ist die Oberfläche unter https://<Server>:11443 erreichbar.

2. Ports

Welche Ports der Container tatsächlich öffnet, zeigt:

sudo ss -tulpn | grep slirp4netns

Die wichtigsten:

Port Protokoll Zweck
11443 TCP Weboberfläche von UniFi OS
8443 TCP UniFi Network (Anwendung)
8080 TCP Inform: Geräte melden sich beim Server
3478 UDP STUN, für Geräte hinter NAT
10003 UDP Geräteerkennung im lokalen Netz
6789 TCP Speedtest der UniFi-App
8880–8882 TCP Weiterleitung zum Gästeportal
5514 UDP Syslog der Geräte

Für Geräte an entfernten Standorten müssen mindestens 8080/TCP und 3478/UDP aus dem Internet erreichbar sein. Die Weboberfläche nach Möglichkeit nur von bekannten IP-Adressen erlauben.

Damit Geräte den Server finden, entweder per SSH set-inform http://<Server>:8080/inform setzen oder die DHCP-Option 43 verwenden.

3. Zertifikat mit Let’s Encrypt

Ein Zertifikat für den Servernamen holen. Im Standalone-Modus braucht certbot dafür kurz Port 80:

sudo apt install certbot
sudo certbot certonly --standalone -d unifi.example.at

Die Dateien liegen danach unter /etc/letsencrypt/live/unifi.example.at/. Zum Hochladen in der Weboberfläche auf den eigenen Rechner kopieren:

scp -r [email protected]:/etc/letsencrypt/live/unifi.example.at/ ~/Documents/cert

In der UniFi-OS-Oberfläche das Zertifikat (fullchain.pem) und den privaten Schlüssel (privkey.pem) als eigenes Zertifikat hinterlegen.

Let’s-Encrypt-Zertifikate laufen nach 90 Tagen ab. certbot erneuert sie automatisch, in UniFi OS muss das neue Zertifikat aber wieder hochgeladen werden.

4. Server aktuell halten

Automatische Sicherheitsupdates für das Betriebssystem aktivieren:

sudo dpkg-reconfigure --priority=low unattended-upgrades
← Alle Anleitungen