Installing the Add-ons Service on a Linux machine

You can install the Add-ons Service as a standalone process on a Linux system.

Before you begin

If you want to run the service on a port other than 83, or if you want to enable HTTPS for the service, modify appsettings.json.

Procedure

  1. Open a console on your Linux machine and navigate to the Add-on Service\ folder you copied.
  2. Grant the start.sh and stop.sh shell scripts execute permission by running the following command:
    chmod +x start.sh stop.sh
  3. Run the following command:
    & .\start.sh
    You can stop the process at any time by running the following command:
    & .\stop.sh
  4. As part of the installation process, the installation script encrypted appsettings.json and stored encrypted information in a newly created folder. After installation has finished, go to the directory in which the Add-on Service was installed and find this subfolder, bin\Key\. Configure the following permissions for this subfolder:
    • Grant full access to the Key\ folder to the user account that ran the start.sh script.
    • Regardless of the script you used, restrict access to the Key\ folder for all other users.

Results

The service is installed and the settings in appsettings.json are encrypted. Any further changes you wish to make to this file require you to decrypt the file before you modify it, and reencrypt the file after you have modified it.