Skip to main content
Skip table of contents

Quick Start Guide for HomeTroller Pi

Start here if you own a HomeTroller Pi

If you purchased HS4 software separately to build your own hub, refer to Quick Start Guide for HS4 instead

Installation & Registration

HomeTroller Pi

  1. Unpack the HomeTroller Pi Hub and AC power supply. Connect an Ethernet cable to the unit and attach that to your router or network switch.
  2. Connect the AC power supply to the unit and plug it in. The unit will power on by itself and HS4 Pi software will launch automatically. You will know HS4 is running by a green LED on the top of your unit.
  3. You’ll need to access the web interface to register your controller and to set it up. Navigate to from another computer on your network. If you are prompted for a username and password in your web browser enter the default username of "default" and the default password of "default". You should then be brought to the installation wizard.
  4. Enter your HS4 License ID & Password, found on the bottom of your unit.
  5. You will be prompted to change the system password. Keep this password saved as you may need it in the future.
  6. Create your HS4 web user account. Follow the prompts and click FINISH at the end.
  7. Proceed to Navigation Overview below.

Navigation Overview

HS4 is a mobile friendly web application that’s designed to be used on any browser-equipped device. All of the essential functions of the program may be accessed from the main navigation bar at the top of the screen.

  • Devices: Click here to add, remove and edit your smart home devices. Learn More
  • Events: Click here to manage your smart home events (automations). Learn More
  • Cameras: Click here to view live camera feeds and to watch recordings. Learn More
  • Setup: Click here manage various system settings. Learn More
  • Tools: Click here to access or manage timers, counters, backup, log and more. Learn More
  • Plugins: Click here to manage HS4 integration plugins. Learn More


Plugins are software programs that allow HS4 to integrate with smart devices and technologies. For example, if you’re using a Z-Wave wall switch and a Zigbee door sensor, you'll need to install both the Z-Wave Plus and Zigbee plugins. Visit Setup Guides for Plugins to learn more about setting up our free HomeSeer plugins. To browse the complete list of all plugins, visit the plugins section of our shop. Visit Installing Plugins for more information on adding plugins to your system.

Creating Devices

Devices are the fundamental building blocks for any HS4 system. When you add any smart product to your system, a corresponding device is added to the software. Device attributes will display as Features Some features are controllable and some will simply display values or status. When you turn the device on or off, your smart product will turn on or off. Here is what a multi-sensor device would look like in the HS4 device list & grid views:

Grid View

List View

Since devices are added by using the controls and procedures engineered into each plugin, you will need to refer to the plugin documentation for more information regarding this.

For more information, Learn more about devices.

Creating Events

Events are rules that work to automate the smart devices in your home.  Each event is comprised of at least one Trigger and one Action. You may also apply Conditions to any trigger. In the example here, a living room lamp is turned on at sunset on Tuesdays.

For more information, Learn more about events.

Using MyHS for Remote Access & Integrations

Our MyHS service provides remote access to your HS4 system and MyHS Premium plans work with other cloud services such as Amazon Alexa, Google Home and IFTTT. MyHS Lite is free to all users. Premium paid plans are also available for users who need additional features. Learn More About MyHS Premium.

Registering a New Account

  1. Visit and click Register. Use the SAME email address & password as your HS4 web user account. Enter your HS4 license ID and password. This will become your primary license.
  2. You will receive a verification email with a link inside. Once you click this link, you will be able to log in and connect via the MyHS web page. If you do not receive the email check your SPAM folder.

Updating an Existing Account

If you already have a MyHS account (for HS3), you can update that account for HS4 with the steps below.

  1. Visit, enter your credentials, then select Manage Account.
  2. Click Change Primary System. Select this and you will be prompted for your old license ID and password combo as well as the new one. If you do not recall your license ID and password, that information can be recovered in the Software Licensing Issues section.

HomeSeer Mobile App

Download and install our HomeSeer Mobile app onto your Android or iOS mobile device. With HomeSeer Mobile, you’ll be able to control your smart devices, launch your HS4 events and access your cameras. You’ll also be able to create custom dashboards for easy access to your most commonly used devices.

Connecting to HS4

  1. Launch HomeSeer Mobile and select the option to Log in to MyHS
  2. Enter your MyHS account credentials and tap Remember Me if you don’t wish to log in each time you run the app.
  3. Tap Log In and you will be connected to your system.

Download HomeSeer Mobile from the appropriate app store.

For more information, Learn more about HomeSeer Mobile.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.