Installing SimpleHelp on macOS
When installing on macOS you will need to use the Terminal app to run 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. 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_222"
OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1~14.04-b10)
OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode)
In the example above, the version 1.8.0_222 signifies a Java 8 installation. Make sure that you Java runtime is Java 8 in order to avoid launching 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 Mac OS 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:
On Mac OS 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 Linux computer is rebooted, please see this document.
