Installing SimpleHelp on macOS

When installing on macOS you will need to use Terminal.app to run commands the installation commands. This is available in the Utilities folder under the Applications folder.

Set up Java

SimpleHelp requires Java 8, and will not launch with Java 9 or later. We suggest installing runtimes from Azul. Your first step should be to check Java is installed and working. In the terminal you should run:

java -version

If Java is present you will see output similar to the following:

openjdk version "1.8.0_322"
OpenJDK Runtime Environment (Zulu 8.60.0.21-CA-macosx) (build 1.8.0_322-b06)
OpenJDK 64-Bit Server VM (Zulu 8.60.0.21-CA-macosx) (build 25.322-b06, mixed mode)

In the example above, the version 1.8.0_322 signifies a Java 8 installation. Make sure that you Java runtime is Java 8 in order to avoid launch issues.

Download, Extract and Install

Next you should download the Other Systems archive from our download page and extract the zip into the folder where you would like to install SimpleHelp.

On macOS systems we recommend installing to the /Applications folder. To do this you can open the folder, copy the zip file into it then double-click it to extract. This will produce a SimpleHelp folder.

You can run the following commands in Terminal to launch your SimpleHelp server:

  cd /Applications/SimpleHelp
  sh serverstart.sh

And the following commands to stop it:

  cd /Applications/SimpleHelp
  sh serverstop.sh

As your SimpleHelp server runs it will print out some startup information and then print out a set of web addresses that you can use to connect from various locations, for example:

    (to connect from a machine across the internet)
    http://1.2.3.4:888/

    (to connect from a machine on the same network)
    http://1.2.3.4:888/

    (to connect from this machine)
    http://1.2.3.4:888/

Open a browser to the relevant address and you will see the Welcome page. From here you can download and install the Technician client to use and configure your server.

Daemon Setup (Optional)

To configure your SimpleHelp server to automatically start when your macOS computer is rebooted, please see this document.