Skip to main content

MacOS

FairCom installation procedures on MacOS for experienced users

The FairCom server is located within a .tar file that you expand into a target folder on your Mac. The target folder should be located somewhere your user has full permissions, such as Documents.

Run the FairCom server

  1. Navigate into the newly-installed server directory through FairCom-<product>.osx.<version>/Contents/Home/Server.

  2. Run the faircom executable or run the startserver script.

Stop the server

  1. Navigate to the newly installed server directory.

  2. Run the stopserver script.

Run the server as a background process

  1. Navigate to the newly installed server directory.

  2. Run the startserver script.

Run the server in production

  • FairCom recommends using systemd command.

  • See also, Script to start and stop the server.

Run multiple instances

You can run multiple instances of FairCom on the same computer by configuring them to use different ports.

Note

Attempting to run a second instance of FairCom with the same port as a running instance will cause the second instance to exit with errors.

Check for running instances of FairCom

  1. Run the command: -ef | grep faircom.

  2. Observe the response.

    • Two lines of code indicate there is a FairCom server running.

    • One line of code indicates there is no FairCom server running.

  3. Alternatively, run the Activity Monitor application and search for faircom.