UniFi OS Server unter Windows installieren: der Nachfolger des UniFi Controllers

Der UniFi OS Server löst den klassischen UniFi Controller (Network Server) zum Selbsthosten ab. Unter Windows läuft er über WSL 2. Diese Anleitung zeigt Voraussetzungen, Installation, den Umzug vom alten Controller und das Adoptieren der Geräte.

Früher hieß die Software zum Selbsthosten „UniFi Controller“, später „UniFi Network Server“. Ihr Nachfolger ist der UniFi OS Server. Er bringt dieselbe Oberfläche mit wie eine Dream Machine oder ein Cloud Gateway, also UniFi OS mit der Network-App, und lässt sich auf einem eigenen Rechner betreiben. Unter Windows läuft er in WSL 2, dem Linux-Subsystem von Windows.

Voraussetzungen

  • Windows 10 oder 11 bzw. Windows Server 2022, 64 Bit
  • In UEFI/BIOS aktivierte Hardware-Virtualisierung (Intel VT-x oder AMD-V)
  • Laut Ubiquiti mindestens 2 GB RAM und 10 GB freier Speicher. Praktisch sind 8 GB RAM und 40 GB freier Platz sinnvoll.
  • Kabelverbindung ins Netz und eine feste IP-Adresse, am einfachsten als DHCP-Reservierung im Router
  • Administratorrechte für die Installation

Innerhalb einer Hyper-V-VM wird der UniFi OS Server von Ubiquiti nicht unterstützt. Er gehört direkt auf den Windows-Rechner.

1. Download

Den Installer gibt es unter ui.com/download/releases/unifi-os-server. Für normale PCs die Variante x64 nehmen, arm64 nur für Windows auf ARM-Prozessoren.

2. Installation

  1. Installer per Rechtsklick „Als Administrator ausführen“.
  2. Dem Assistenten folgen. Fehlt WSL 2, richtet der Installer es ein. Alternativ vorher in einer Administrator-PowerShell wsl --install ausführen.
  3. Windows neu starten, wenn danach gefragt wird, und mit demselben Benutzer anmelden.
  4. UniFi OS Server über das Startmenü starten. Der erste Start dauert ein paar Minuten.
  5. Die Oberfläche erreicht man von einem anderen Rechner im Netz unter https://IP-DES-PCS:11443. Die Zertifikatswarnung beim ersten Aufruf ist normal.
  6. Namen für die Konsole vergeben und mit einem UI-Konto oder einem lokalen Konto anmelden. Ohne UI-Konto fallen Fernzugriff über Site Manager und Teleport weg.

3. Netzwerkprofil und Firewall

Das Netzwerkprofil des Rechners muss in Windows auf „Privat“ stehen, sonst blockiert die Firewall die Geräte. Die Geräte melden sich wie beim alten Controller über TCP 8080, dazu kommen unter anderem UDP 3478 (STUN) und TCP 11443 für die Oberfläche. Eine eigene Firewall-Software auf dem PC muss diese Ports im lokalen Netz zulassen.

4. Autostart

Einen Windows-Dienst wie beim alten Controller gibt es beim UniFi OS Server derzeit nicht. Über das Tray-Symbol lässt sich „Start with System“ aktivieren. Das startet den Server aber erst, wenn sich der Benutzer anmeldet. Der Rechner braucht deshalb eine automatische Anmeldung oder muss angemeldet bleiben. Für einen Server, der rund um die Uhr laufen soll, ist ein Linux-Rechner oder ein Cloud Gateway oft die bessere Wahl.

5. Umzug vom alten UniFi Controller

  1. Im alten Controller unter Settings → System → Backups ein aktuelles Backup herunterladen.
  2. Beim ersten Start des UniFi OS Servers „Restore from backup“ wählen und die Datei hochladen.
  3. Den alten Controller erst abschalten, wenn alle Geräte im neuen Server als „Online“ erscheinen.

Hat der neue Rechner eine andere IP-Adresse als der alte, finden die Geräte den Server nicht von selbst. Dann für jedes Gerät die Inform-Adresse neu setzen, siehe nächster Abschnitt.

6. Geräte adoptieren

Neue Geräte im selben Netz erscheinen nach ein bis zwei Minuten unter „UniFi Devices“ zum Adoptieren. Klappt das nicht, hilft ein manuelles set-inform:

  1. IP-Adresse des Geräts im Router nachsehen.
  2. Per SSH verbinden: ssh ubnt@IP-DES-GERAETS, das Standardkennwort bei Werkseinstellungen ist ubnt.
  3. set-inform http://IP-DES-WINDOWS-PCS:8080/inform eingeben.
  4. In der Oberfläche auf „Adopt“ klicken.

Typische Probleme

  • Installer bricht ab oder der Server startet nicht: Virtualisierung im BIOS prüfen und wsl --status in der PowerShell ausführen.
  • Oberfläche nicht erreichbar: Netzwerkprofil auf „Privat“ stellen und prüfen, ob der Benutzer angemeldet ist.
  • Geräte bleiben auf „Adopting“ hängen: Port 8080 wird blockiert oder die IP des PCs hat sich geändert.

Fragen zur Installation oder zum Umzug? Im Forum UniFi OS Server, Network App & Cloud Key ein Thema mit Windows-Version, Server-Version und einer Beschreibung des Fehlers eröffnen.