Unifi Controller als Dienst installieren

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.

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 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.