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
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:
If Java is present you will see output similar to the following:
openjdk version "1.8.0_322" OpenJDK Runtime Environment (Zulu 220.127.116.11-CA-macosx) (build 1.8.0_322-b06) OpenJDK 64-Bit Server VM (Zulu 18.104.22.168-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
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://22.214.171.124:888/ (to connect from a machine on the same network) http://126.96.36.199:888/ (to connect from this machine) http://188.8.131.52: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.