HomeSeer Linux Installer Package/Scripts

(Developed with ♥ by SavageSoftware, LLC.)

Disclaimers

• This repository is not supported, sponsored or directly affiliated with Homeseer (https://homeseer.com/).
• We are not responsible for any data lost or systems corrupted!

---

TL;DR

Install Homeseer on your (Debian-based) Linux system:

curl -sSL https://homeseer.sh/install | sudo bash

---

Contents

• Overview
  • Resource Links
• Prerequsites
  • OS/Distribution
  • Update OS
  • Curl
• Installation
  • Automated Installation
  • Manual Installation
• Uninstall
  • Uninstallation
  • Complete Uninstallation/Removal
• Advanced
  • Install Explicit Versions
  • Enable Beta/Release Candidate Versions
• Installation Notes/Details
  • Location/Path
  • Service/Daemon
  • User Account
• Service Control
  • Start
  • Stop
  • Restart
  • Status
• Debian Installation Notes

---

Overview

The purpose of this repository is to host automated installation scripts and APT/PPA repository packages for installing HomeSeer on Debian-based Linux systems. The latest official release packages and release notes for HomeSeer can be found at: https://docs.homeseer.com/display/HSPI/HS4+Release+Notes

This repository is not supported, sponsored or directly affiliated with Homeseer (https://homeseer.com/).

Resource Links

• WebPage: https://homeseer.sh
• GitHub Repository: https://github.com/HomeSeerLinux/homeseerlinux.github.io
• APT/PPA Package Repository: https://github.com/HomeSeerLinux/download

---

Prerequsites

Operating System / Distribution

A Debian-based distribution of Linux is required to use this installation script and APT/PPA repository. The following distributions have been tested:

OS/Distribution	Version	Notes
Ubuntu	20.04	✅ Installation successful; No known issues
Linux Mint	20.2	✅ Installation successful; No known issues
PopOS!	21.04	✅ Installation successful; No known issues
Debian	10.10, 11.1	❗ Package fails to install in Debian 10, 11. See this section for details on installing on Debian 10 & 11

Update OS

An update was performed on each distribution prior to installation.

sudo apt update 
sudo apt upgrade

Curl

Curl must be installed to download and execute the automated installation script.

sudo apt install curl -y

---

Automated Installation

The following command will use our pre-built installation scripts to install the latest release of Homeseer on your (Debian-based) Linux system:

curl -sSL https://homeseer.sh/install | sudo bash

📌 Before running this script blindly with sudo privileges on your system, you should inspect the script contents to ensure there are no nefarious or malicious actions taking place. You can also view the file contents using this command: curl https://homeseer.sh/install.

Manual Installation

If you prefer not to use the simple script above due the the security nature of blindly allowing a script to run with sudo privileges, you can also use these commands to setup the appropriate Homeseer.sh APT/PPA repository on your local system:

wget -qO- https://homeseer.sh/homeseer.gpg | sudo apt-key add -
echo 'deb [arch=all signed-by=/etc/apt/keyrings/homeseer.gpg] https://homeseer.sh/download v4 stable' | sudo tee /etc/apt/sources.list.d/homeseer.list
sudo apt update
sudo apt install homeseer

---

Uninstall

The following command will remove the Homeseer application files from your (Debian-based) Linux system:

sudo apt remove homeseer

This method will leave any configurtation files, data files, log files and installed plugin files on the system in the /opt/HomeSeer directory. This method will also leave the Homeseer.sh APT/PPA repository configured in case you wish to re-install HomeSeer later.

Complete Automated Removal / Complete Uninstall

The following command will use our pre-built uninstallation scripts to remove the HomeSeer application file and Homeseer.sh APT/PPA repository configuration files from your (Debian-based) Linux system:

curl -sSL https://homeseer.sh/uninstall | sudo bash

📌 Before running this script blindly with sudo privileges on your system, you should inspect the script contents to ensure there are no nefarious or malicious actions taking place. You can also view the file contents using this command: curl https://homeseer.sh/uninstall.

The following command will completely remove/wipe all Homeseer data, log and configutation files from your (Debian-based) Linux system:

sudo rm -R /opt/HomeSeer

The following command will remove/wipe the homeseer user account (used by the homeseer.service daemon) from your (Debian-based) Linux system:

sudo deluser homeseer

⚠️ This uninstall script and commands will remove all Homeseer application files, data files and configuration files from your local system. Please backup your Homeseer configuation data before uninstalling using this script/commands.

---

Install Explict Versions

Once your system has been configured with the Homeseer APT/PPA repository you can use the apt install command to install explict versions of Homeseer uisng the ={VERSION} syntax as shown in the example below.

sudo apt install homeseer=4.2.0.0

---

Enable Beta/Release Candidate Versions

Once your system has been configured with the Homeseer APT/PPA repository you can modify the /etc/apt/sources.list.d/homeseer.list file if you would like to enable installing BETA and RELEASE CANDIDATE versions.

1.) Edit the /etc/apt/sources.list.d/homeseer.list file using your favorite text editor:

sudo nano /etc/apt/sources.list.d/homeseer.list

2.) Edit the line with the https://homeseer.sh/download URI and include the testing label/tag at the end of the line as shown below.

deb [arch=all signed-by=/etc/apt/keyrings/homeseer.gpg] https://homeseer.sh/download v4 stable testing

3.) Save the updated file and exit the text editor.

4.) Perform an apt update to load/refresh the lastest available packages.

sudo apt update

5.) Finally you can install the lastest version using the following command.

sudo apt install homeseer

📌 The latest version is determined by the semantic version number. If an avaialble BETA or RELEASE CANDIDATE version is higher than the lasted release, then that BETA or RC version will be installed.

Alternatively you can install the explict version using the ={VERSION} syntax as shown in the example below.

sudo apt install homeseer=4.2.7.0

---

Installation Notes / Details

Location / Path

The Homeseer Debian installed package will install Homeseer to the following location:

/opt/HomeSeer

Service / Daemon

The Homeseer Debian installed package will install a homeseer.service (systemd) to run Homeseer automatically on startup and in the background. The homeseer.service (systemd) configuration is stored in the following location:

/etc/systemd/system/homeseer.service

🔎 View the contents of the homeseer.service file here

On completion of the installation, the Homeseer service should be started automatically.

User Account

The Homeseer Debian installed package will create a homeseer system user account for use with the homeseer.service service/daemon.

---

Service Control

The following commands can be used to start, stop, restart and check the status of the Homeseer service/daemon.

Start Service

You can start the Homeseer service using the following command:

sudo service homeseer start

Stop Service

You can stop the Homeseer service using the following command:

sudo service homeseer stop

Restart Service

You can restart the Homeseer service using the following command:

sudo service homeseer restart

Service Status

You can check the status of the Homeseer service using the following command:

sudo service homeseer status

---

Debian Installation Notes

This installation script and *.deb installer package fails to install on Debian (10 & 11) due to the following unmet dependencies in the installer package.

Package	Issue	Solution.
mono-complete	Not available.	Add custom PPA and install package.
mono-devel	Not available.	Add custom PPA and install package.
mono-vbnc	Not available.	Add custom PPA and install package.
chromium-browser	Not available.	Install chromium package instead.
alsa-base	Not available.	Install alsamixergui package instead.

These dependencies can be install in Debian manually using the following commands:

1.) Install the Mono framework:

sudo apt update && sudo apt upgrade
sudo apt install dirmngr gnupg apt-transport-https ca-certificates -y
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
sudo sh -c 'echo "deb https://download.mono-project.com/repo/debian stable-buster main" > /etc/apt/sources.list.d/mono-official-stable.list'
sudo apt update
sudo apt install mono-complete -y
sudo apt install mono-devel -y
sudo apt install mono-vbnc -y

2.) Install other dependencies:

sudo apt install curl -y
sudo apt install chromium -y
sudo apt install alsamixergui -y

3.) Install the Homeseer (*.deb) debian installation package via the automated installation script.

curl -sSL https://homeseer.sh/install | sudo bash

---