By default, the UniFi controller will operate on the following ports:
- unifi.http.port=8080 (port for UAP to inform controller)
- unifi.https.port=8443 (port for controller GUI / API, as seen in web browser)
- portal.http.port=8880 (port for HTTP portal redirect)
- portal.https.port=8843 (port for HTTPS portal redirect)
- unifi.db.port=27117 (local-bound port for DB server)
Note: In version 4.5.2 and later, users can also define the port assigned to STUN services, for scenarios where two or more separate UniFi instances are desired on the same controller machine.
- unifi.stun.port=3478 # UDP port used for STUN
Note: Since v3.2.9+ and v4.6.0+, two more ports are being reserved for device redirector. There is no need to open firewall for these ports on controller, however, on controller, avoid to use these ports.
- port 8881 for redirector port for wireless clients
- port 8882 for redirector port for wired clients
Changing the Ports
UniFi gives operators the freedom to change these ports from their default assignments. By using a network utility (netstat, etc.), users can determine which ports are in use/opened/closed. The steps are outlined below:
- Close any instances of UniFi software running on controller(s)
- Modify the file system.properties accordingly—the file can be found in the directory <unifi_base>/data/system.properties
- Make sure all ports needed by UniFi are available
- Restart UniFi
IMPORTANT: Make sure not to place any spaces, comments, or other characters after any of the custom lines as the controller will ignore your customizations if you do so.
- Run “netstat – ano” command in the command line.
- Locate the PID for the mentioned port in use.
- Open task manager and select view and select columns , put a check for PID (process identifiers)
- Check the process corresponding to the PID located for the port during step 2.
- End the process if it is possible.
- If not possible go on the location <unifi_base>/data and open the system file with word or notepad.
- Modify this file to change the port that was in use. For example if port 8081 was in use you would modify the line "unifi.shutdown.port=8081" to something like "unifi.shutdown.port=8089" assuming port 8089 was not already in use.
NOTE: In the event that the controller software has either never run on the system, or can't run because of a port conflict, then either the controller software (assuming no existing port conflict) or the UniFi Discovery utility, needs to be run (which will also generate the system.properties file.)
Note: The following video is based on v2.x, however, the system.properties file still rests in the same directory "<unifi_base>/data/system.properties" in v3 and v4.