Running Ignition on port 80 in Linux

Intro

This Knowledge Base Article will walk you through the steps necessary to configure Ignition to run on port 80 on a Linux operating system.  Linux by default will not allow you to run anything on port 1024 and below. You may need to configure Ignition to run as the root user.

Checking and changing the user

For this article I will be performing all of my steps in the Ubuntu GUI. For more advanced uses you can perform all of your changes in Terminal. You will first navigate to /usr/local/bin/ignition and open the ignition.sh file for editing.

Once you have ignition.sh open, look for the line that contains ‘RUN_AS_USER=’ and make sure it equals ‘root’ and save your changes.

Changing the port

 You can change the ports Ignition uses with the Gateway Control Utility (GCU). After launching the GCU as sudo place the desired port numbers in the the Port and SSL Port fields and select save. After saving you will be prompted to restart the gateway service.

The port can be changed in Terminal by using the gwcmd. Keep in mind, once you change the port(s) you will need to restart the gateway service.  To make the change in terminal follow these steps:

1. Launch Terminal
2. Change directory to where gwcmd.sh located. The default location should be /usr/local/bin/ignition.
3. Change the port. I prefixed my command with sudo. The command to change the port looks like sudo ./gwcmd --port 80. To change the SSL port you will use sudo ./gwcmd --sslport 443.
4. Enter your password to continue.
5. Once the port is changed you will see a message indicating the port was changed and the gateway must be restarted for the change to take effect.