Zum Inhalt springen
CloudZH

Doku / Netz

UniFi OS Server

Betreibe die UniFi-Network-Anwendung für deine Access Points und Switches auf dem CloudZH-Server.

Installieren

zh unifi install

UniFi OS Server läuft rootless mit Podman unter einem eigenen Benutzer. Öffne ihn unter https://unifi.example.com hinter deinem Login oder zu Hause unter https://<server-ip>:11443, zum Beispiel https://192.168.1.200:11443.

Inform-Adresse

Deine UniFi-Geräte melden sich bei der Adresse in Inform host override. CloudZH trägt dort selbst die Kabel-Adresse des Servers ein und prüft sie bei jedem Start und alle 6 Stunden, damit sich Geräte nie bei einer WLAN- oder Container-Adresse melden. Anzeigen oder ändern auf dem Server:

zh unifi inform              # show
zh unifi inform <server-ip>   # a fixed address instead
zh unifi inform auto         # back to automatic

Umzug von einem anderen Controller

Ein Gerät gehorcht nur einem Controller. Halte genau einen aktiv.

  1. Erstelle im alten Controller ein Backup (Network → Settings → System → Backups) und stelle es in der Network-App auf CloudZH wieder her.
  2. Prüfe die Inform-Adresse mit zh unifi inform.
  3. Richte jedes Gerät per SSH auf den neuen Controller aus. <device-ip> ist die Adresse des Access Points oder Switches, <server-ip> die des Servers:
    ssh admin@<device-ip>
    set-inform http://<server-ip>:8080/inform
    Die SSH-Sitzung bricht ab, während das Gerät provisioniert wird. Das ist normal.
  4. Prüfe mit info auf dem Gerät: Connected (http://<server-ip>:8080/inform). Stoppe dann den alten Controller.
Server per Kabel anschliessen

Erreicht der Server dein Netzwerk über den Access Point, den er selbst verwaltet, schneidet ihn ein Firmware-Update oder eine falsche Einstellung von sich selbst ab. Schalte automatische Geräte-Updates aus, solange der Server im WLAN hängt.

UniFi OS Server unterstützt die Network-Anwendung. Protect, Access und Talk brauchen eine UniFi-Konsole.