How to change the port number of the LEAPWORK Controller after installation

There are two ways to change the port number, which controls the communication between LEAPWORK Studio and LEAPWORK Controller:

1) Uninstall and Re-Install

During installation it is possible to specify the port number. Be aware that all work done previously will be removed using the uninstall-reinstall approach.

To un-install LEAPWORK, do the following:

1. Open a run box by pressing “LEFT WINDOWS” key and “R”:

2. Enter “control panel” and press “ENTER”

3. Select “Programs – Uninstall a program” and find LEAPWORK in the list of installed programs

4. Right-click LEAPWORK and select Uninstall

To re-install please follow this article: Download and/or Upgrade LEAPWORK.

2) Changing the port settings manually

The (very) manual way of changing the port number and avoiding re-installation is described in the following:

1. Stop the LEAPWORK Controller:

   1. Press Win+R combination to open Run dialog

   2. Type ‘services.msc’ and press Enter to open the Services window

   3. Find LEAPWORK Controller, click the right mouse button and select the “Stop” command.

2. Change the LEAPWORK Controller port:

   1. Navigate to C:\Program Files\LEAPWORK\Controller

   2. Find the controller.config file and open it using Notepad

   3. Change the “ControllerPort” to another port

3. Update the LEAPWORK controller port in Studio:

   1. Open LEAPWORK, navigate to Settings=> Controller settings

   2. Create a new controller or edit the existing one 

   3. Update the new Port number (changed in point number 2, above) then save.

           

4. You need to open the selected port at the system firewall. Note that LEAPWORK installer does that automatically during installation:

1. On the Start menu, click Control Panel

2. In Control Panel, find and then open Windows Firewall

3. In Windows Firewall, click the Advanced settings menu

4. Press the right mouse button at Inbound Rules and then click New Rule

5. Select Port and press Next

6. Select TCP rule at the next step and type Specific port

7. Select “Allow the connection” and apply the rule to “Domain”, “Private” and “Public”

8. In the Name box type “LEAPWORK Controller” and press Finish

9. Repeat the same steps for Outbound Rules.

5. Start LEAPWORK Controller then follow the steps from point number 1 above, but use the “Start” command at the last step.

6. Open LEAPWORK Studio and check if it can connect to the configured Controller. You can always see the address that LEAPWORK Studio is trying to connect to the LEAPWORK Controller with, in the bottom-left corner of the application.

For any clarification, please contact our Priority Support.