Unifi Controller als Dienst starten

Selbst-Hosting eines UniFi Network Servers als Windows-Dienst

Das Betreiben eines UniFi Network Servers auf einem Windows-Betriebssystem kann auf zwei Arten erfolgen:

  1. Über den Launcher: UniFi Network läuft im Vordergrund (Standardmethode).
  2. Als Windows-Dienst: UniFi Network läuft im Hintergrund (fortgeschritten, Anleitung unten).

Diese Methode gilt nur für UniFi Network Server, die auf Windows Desktop (Windows 10 / 11) installiert sind, nicht für Windows Server-Versionen.

Neuinstallation

UniFi Network Server herunterladen und installieren

Lade den UniFi Network Server für Windows von der offiziellen Download-Seite herunter und führe das Installationsprogramm aus. Es wird empfohlen, die neueste Version zu verwenden.

Passende Java Runtime Environment (JRE) herunterladen

Je nach UniFi Network-Version benötigt das System eine bestimmte Java-Version:

  • UniFi Network 7.5 und früher: Java 11
  • UniFi Network 7.5 bis 8.6: Java 17
  • UniFi Network 9.0 und später: Java 17 oder Java 21

Java installieren und JAVA_HOME setzen

Installiere die passende Java-Version und setze die JAVA_HOME-Variable auf „Wird auf lokaler Festplatte installiert“.

Hinweis: Falls es Probleme mit dem Java-Installer oder der Umgebungsvariable JAVA_HOME gibt, entferne alte Java-Versionen vom System.

Notwendige Ports in der Firewall freigeben

Die folgenden Ports müssen in der Windows-Firewall oder in Antivirus-Programmen freigegeben werden:

  • TCP Port 8080
  • TCP Port 8843
  • UDP Port 10001
  • UDP Port 3478

Weitere Informationen findest du in der offiziellen Port-Referenz.

Eingabeaufforderung als Administrator öffnen

Zum Installationsverzeichnis wechseln

Wechsle in das Verzeichnis, in dem der UniFi Network Server installiert wurde:

cd "%UserProfile%\Ubiquiti UniFi\"

UniFi Network Server als Dienst installieren

java -jar lib\ace.jar installsvc

Warte, bis die Installation mit der Meldung „Complete Installation“ abgeschlossen ist.

Dienst starten

java -jar lib\ace.jar startsvc

Webinterface aufrufen

Öffne einen Browser und rufe die folgende Adresse auf, um die Konfiguration durchzuführen:

https://localhost:8443

Alternativ kannst du die IP-Adresse des Servers verwenden.

Upgrade einer bestehenden Installation

Backup erstellen und UniFi Network Server beenden

Lade ein Backup der UniFi Network Server-Konfiguration herunter und beende den Server.

Eingabeaufforderung als Administrator öffnen

Zum Installationsverzeichnis wechseln

cd "%UserProfile%\Ubiquiti UniFi\"

UniFi Network Server-Dienst deinstallieren

java -jar lib\ace.jar uninstallsvc

Warte, bis die Deinstallation abgeschlossen ist.

Neue Version installieren

Befolge die Schritte aus der Sektion Neuinstallation, um die aktualisierte Version als Dienst zu installieren.