Unifi Controller als Dienst starten

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

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, die auf Windows Desktop (Windows 10 / 11) installiert sind, nicht für Windows Server-Versionen.

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 Java 11 Java 17 Java 21 7.5 und früher ✓ ✕ ✕ 7.5 bis 8.6 ✕ ✓ ✕ 9.0 und später ✕ ✓ ✓
  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:8443 Alternativ kannst du die IP-Adresse des Servers verwenden.

Upgrade einer bestehenden Installation

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

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.

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 Java 11 Java 17 Java 21 7.5 und früher ✓ ✕ ✕ 7.5 bis 8.6 ✕ ✓ ✕ 9.0 und später ✕ ✓ ✓
  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
    Wechsle 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:8443 Alternativ 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 uninstallsvc Warte, 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.