Welcome to the Alteryx Knowledge Base

Answer

The Service Port can only be modified by manually editing a critical configuration file called "RuntimeSettings.xml." It's important to note that there are two files with this name installed on a Server:

1. There is a read-only file called RuntimeSettings.xml installed in the root Alteryx installation folder, which by default is C:\Program Files\Alteryx\bin\RuntimeData\RuntimeSettings.xml. This core settings configuration file used by Alteryx must never be edited.
2. There is a second file called RuntimeSettings.xml located at C:\ProgramData\Alteryx\RuntimeSettings.xml. The Alteryx System Settings dialog creates and modifies this file and contains settings overridden from the base configuration file in (1).

**Please note that the settings should only be modified using the Alteryx System Settings dialog, as incorrect or incomplete settings could prevent your Server from running correctly.**

 

Please proceed with caution. This is especially important if you run a multiple-node Server installation, as all nodes will need updated Controller information. Similarly, Alteryx Designer users using the scheduler will also be impacted by the change.

If you "must" change the Service Port, schedule planned Server downtime with your users. Follow these steps:
 

1. Navigate to C:\ProgramData\Alteryx\
2. Create a copy of the file RuntimeSettings.xml
3. Open Alteryx System Settings and add the port to the Base Address like so: http://localhost:your_desired_service_port/gallery/
    
   • 
     
     
4. Click on Next until you finish.
5. As an Administrator, start Notepad and open RuntimeSettings.xml
6. In the <Controller> section add the following setting <ServicePort>##</ServicePort> and save the file
   
   
   • 
     
     
7. Restart the Server (using the Service Control Manager or Services tab in Task Manager)
8. Verify Server operation

Note:  In the XML file, under <Gallery>, you can check the <BaseAddress> to see if the port is showing for the address.