Selbst-Hosting eines UniFi Network Servers als Windows-Dienst (Erweitert)

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

  1. 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.
  2. Passende Java Runtime Environment (JRE) herunterladen
    Je nach UniFi Network-Version benötigt das System eine bestimmte Java-Version:
    UniFi Network Version 7.5 Java 11
    UniFi Network Version 7.5 bis 8.6✕ Java 17
    UniFi Network Version 7.5 bis 8.6 – 9.0 und später Java 21
  3. 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.
  4. 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.
  5. Eingabeaufforderung als Administrator öffnen
  6. Zum Installationsverzeichnis wechseln
    Wechsel in das Verzeichnis, in dem der UniFi Network Server installiert wurde:
    cd "%UserProfile%\Ubiquiti UniFi\"
  7. UniFi Network Server als Dienst installieren
    java -jar lib\ace.jar installsvc
    Warte, bis die Installation mit der Meldung „Complete Installation“ abgeschlossen ist.
  8. Dienst starten
    java -jar lib\ace.jar startsvc
  9. Webinterface aufrufen
    Öffne einen Browser und rufe die folgende Adresse auf, um die Konfiguration durchzuführen:
    https://localhost:8443Alternativ kannst du die IP-Adresse des Servers verwenden.

Upgrade einer bestehenden Installation

  1. Backup erstellen und UniFi Network Server beenden
    Lade ein Backup der UniFi Network Server-Konfiguration herunter und beende den Server.
  2. Eingabeaufforderung als Administrator öffnen
  3. Zum Installationsverzeichnis wechseln
    cd "%UserProfile%\Ubiquiti UniFi\"
  4. UniFi Network Server-Dienst deinstallieren
    java -jar lib\ace.jar uninstallsvcWarte, bis die Deinstallation abgeschlossen ist.
  5. Neue Version installieren
    Befolge die Schritte 1-9 aus der Sektion Neuinstallation, um die aktualisierte Version als Dienst zu installieren.