HS4 for Linux is a modified version of HS4 that runs under Linux. It is full HS4 with the following exceptions:

* No VBScript support (.txt scripts). VB.Net scripting and C# scripting is supported

HS4 for Linux does not require a distinct license. Your HS4 standard, HS4 SEL/Plus, or PRO license will work, though note that you can only use one license per installation.

Linux can be a challenge for non-technical users, the Linux version of HS4 is targeted to the more technical user.


These instructions have been tested under Debian and Ubuntu.

  1. Install Debian or Ubuntu per its instructions. Ubuntu on Windows 10 will also work.
  2. Install the following packages that are required by HS4:
    Note that MONO is required, but it is already installed with the Debian distribution. However, a few packages are missing:
    apt-get install mono-devel
    apt-get install mono-vbnc
    apt-get install flite
    apt-get install chromium
    apt-get install aha
    apt-get install ffmpeg
    apt-get install aplay
  3. If brltty is installed, this must be removed in order for a Z-Stick to work:
    apt-get remove brltty
  4. Download the latest HS4 tar file, latest release can be found here: https://docs.homeseer.com/display/HSPI/Release+Notes
  5. Download the latest "Linux Standard" tar file.
  6. Change the directory to where you want to install it.
    Our default is:
    cd /usr/local
  7. untar with the command:
    tar xvf tar_filename
  8. Change directory into the newly created HomeSeer folder:
    cd HomeSeer
  9. Run HS4 using the "go" script:


HS4 needs to run as root or with sudo (script uses sudo). This is because it listens on a port for the webserver and MONO requires root to do this.

Check the startup log for errors. If all is ok, you can access the web interface on a browser by accessing the IP address if the Linux system with:


By default, HS4 starts listening on port 80. If you happen to have the Apache webserver installed port 80 may be in use. You can edit the HS4 config file in Config/settings.ini and change the setting to a different port, then restart HS4. In the settings file the server port can be changed by adding or modifying the following line:


You can shut down HS4 from the console by hitting enter to get a prompt and then entering: shutdown