Getting started

Installing HomeGenie Server 2.0

1. Download

Select your target operating system and architecture from the dropdown menu, then copy and paste the commands into your terminal to download and extract the latest release.

Select target architecture:

Enter the following commands in a PowerShell terminal:

# Download the archive
curl -L -o homegenie_2.0.0-rc.8_win-x64.zip "https://github.com/genielabs/HomeGenie/releases/download/v2.0.0-rc.8/homegenie_2.0.0-rc.8_win-x64.zip"
# Unzip the archive
Expand-Archive -Path homegenie_2.0.0-rc.8_win-x64.zip -DestinationPath . -Force

Enter the following commands in a terminal:

# Download the archive
curl -L -O "https://github.com/genielabs/HomeGenie/releases/download/v2.0.0-rc.8/homegenie_2.0.0-rc.8_osx-x64.zip"
# Unzip the archive
unzip homegenie_2.0.0-rc.8_osx-x64.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.0-rc.8/homegenie_2.0.0-rc.8_linux-x64.zip
# Unzip the archive
unzip homegenie_2.0.0-rc.8_linux-x64.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.0-rc.8/homegenie_2.0.0-rc.8_linux-arm.zip
# Unzip the archive
unzip homegenie_2.0.0-rc.8_linux-arm.zip

Enter the following commands in a terminal:

# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.0-rc.8/homegenie_2.0.0-rc.8_linux-arm64.zip
# Unzip the archive
unzip homegenie_2.0.0-rc.8_linux-arm64.zip

2. Run from Terminal

Once extracted, a homegenie folder will be created. Navigate into it and start the application:

cd homegenie
./HomeGenie

To stop the application, press CTRL + C in the terminal.

The video above demonstrates the installation process on a Raspberry Pi Zero 2 W using the official Raspberry Pi Imager with Raspberry Pi OS Lite (32-bit).

For instructions on how to run HomeGenie as a system service and for other advanced settings, please see the Optional Post-Installation Steps guide.

3. Access the UI

HomeGenie's user interface can be accessed from any web browser on your network.

URL: http://<server_ip>:<port>/

<server_ip> is the IP address of the machine where HomeGenie is running.
The default <port> is 80, or if not available, the first available port starting from 8080. (Example: http://192.168.1.150:8080/)

To find the exact address and port, check the serviceaddress.txt file in the homegenie folder after the first run:

cat homegenie/serviceaddress.txt

You can change the port settings from the Settings > Maintenance page or by manually editing the systemconfig.xml file (while the service is stopped).

forum Q & A discussion forum