Community Spring Cleaning week is here! Join your fellow Maveryx in digging through your old posts and marking comments on them as solved. Learn more here!

Alteryx Server Knowledge Base

Definitive answers from Server experts.

How to Run Alteryx Server on a port other than 80

AngelaO
Alteryx Alumni (Retired)
Created

Question

 

How do you reserve port 80 on a server for a reverse proxy that Alteryx Server would sit behind? Ideally, anything off the box could still connect using 80, but locally it would be configured it to use a different port.
 

Answer

 

The Service Port can be currently only be modified by manually editing a key 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 is thecore settingsconfiguration file used by Alteryx and must never be edited.
  2. There is a second file called RuntimeSettings.xml located at C:\ProgramData\Alteryx\RuntimeSettings.xml. This file is created and modified by the Alteryx System Settings dialog, and contains settings overridden from the base configuration file in (1).

**Please note that the settings should only ever 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 are running a multiple-node Server installation, as all nodes will need their Controller information updated. Similarly, Alteryx Designer users using the scheduler will also be impacted by the change.

 

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

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

Example:

CristianoJ_0-1661545824276.png

 

CristianoJ_1-1661545870258.png