UniFi OS Server

Run the UniFi Network application for your access points and switches on the CloudZH server.

Install

zh unifi install

UniFi OS Server runs rootless with Podman under its own user. Open it at https://unifi.example.com behind your login, or at home on https://<server-ip>:11443, for example https://192.168.1.200:11443.

Inform address

Your UniFi devices report to the address in Inform host override. CloudZH enters the cable address of the server there by itself and checks it at every start and every 6 hours, so devices never report to a Wi-Fi or container address. Show or change it on the server:

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

Moving from another controller

A device obeys one controller only. Keep exactly one active.

Create a backup in the old controller (Network → Settings → System → Backups) and restore it in the Network app on CloudZH.
Check the inform address with zh unifi inform.
Point each device to the new controller over SSH. <device-ip> is the address of the access point or switch, <server-ip> that of the server:
```
ssh admin@<device-ip>
set-inform http://<server-ip>:8080/inform
```
The SSH session drops while the device provisions. That is normal.
Check with info on the device: Connected (http://<server-ip>:8080/inform). Then stop the old controller.

Connect the server by cable

If the server reaches your network through the access point it manages, a firmware update or a wrong setting cuts it off from itself. Turn off automatic device updates while the server is on Wi-Fi.

UniFi OS Server supports the Network application. Protect, Access and Talk need a UniFi console.