UniFi - Change Default Ports for Controller and UAPs

Overview


This article describes how to change ports from their default assignments. Find the different default ports in our UniFi - Ports Used article.

Table of Contents


  1. Steps - How to Change Ports
  2. Example (Windows)
  3. Video Tutorial
  4. Related Articles

 

Steps - How to Change Ports


Back to Top

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:

  1. Close any instances of UniFi software running on controller(s)
  2. Modify the file system.properties accordingly—the file can be found in the directory <unifi_base>/data/system.properties
  3. Make sure all ports needed by UniFi are available
  4. 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.


Example (Windows)


Back to Top

  1. Run “netstat – ano” command in the command line.
  2. Locate the PID for the mentioned port in use.
  3.  Open task manager and select view and select columns , put a check for PID (process identifiers)
  4. Check the process corresponding to the PID located for the port during step 2.
  5. End the process if it is possible.
  6. If not possible go on the location <unifi_base>/data and open the system file with word or notepad. Note: Not sure where to find <unifi_base>? See this article.
  7. 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.
info_i_25x25.png 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.)
 
Windows or Mac will have an icon for the discovery utility but Linux will not. Users on Linux will have to load it via CLI: java -jar /usr/lib/unifi/lib/ace.jar discover 

 


Video Tutorial


Back to Top

info_i_25x25.png 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, v4 and v5.

 


Related Articles


Back to Top

UniFi - system.properties File Explanation

UniFi - Ports Used