HomeGenie - Dashboard - Demo Setup
Open media
Installing HomeGenie
HomeGenie is designed to be portable and frictionless. It doesn't require a complex installation process—you simply download, extract, and launch.
1. Download the Package
You can choose the method that best fits your workflow:
Option A: Direct Download (Recommended for Desktop)
The simplest way to get started is to download the pre-compiled zipped folder for your platform directly from the HomeGenie release page on GitHub.
Which file should I download?
Choose the package that matches your operating system and hardware:
- Windows: Download
win-x64.zip(standard 64-bit PC). - macOS: Download
osx-x64.zip(Intel or Apple Silicon via Rosetta 2). - Linux (PC/Server): Download
linux-x64.zip(Ubuntu, Debian, etc., on standard 64-bit hardware). - Raspberry Pi / ARM: Download
linux-arm64.zipfor modern 64-bit operating systems (recommended for Pi 4/5) orlinux-arm.zipfor older 32-bit systems.
Once the download is complete, extract the archive to your preferred location and proceed to Step 2 to launch the system.
Option B: Terminal Download (Recommended for Remote Servers & ARM)
If you are setting up HomeGenie on a headless Linux server or a Raspberry Pi, you can perform the download and extraction directly via the terminal.
Select your target operating system and architecture from the dropdown menu below, then copy and paste the generated commands into your terminal:
Select target architecture:
Enter the following commands in a PowerShell terminal:
# Download the archive
curl -L -o homegenie_2.0.14_win-x64.zip "https://github.com/genielabs/HomeGenie/releases/download/v2.0.14/homegenie_2.0.14_win-x64.zip"
# Unzip the archive
Expand-Archive -Path homegenie_2.0.14_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.14/homegenie_2.0.14_osx-x64.zip"
# Unzip the archive
unzip homegenie_2.0.14_osx-x64.zip
Enter the following commands in a terminal:
# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.14/homegenie_2.0.14_linux-x64.zip
# Unzip the archive
unzip homegenie_2.0.14_linux-x64.zip
Enter the following commands in a terminal:
# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.14/homegenie_2.0.14_linux-arm.zip
# Unzip the archive
unzip homegenie_2.0.14_linux-arm.zip
Enter the following commands in a terminal:
# Download the archive
wget https://github.com/genielabs/HomeGenie/releases/download/v2.0.14/homegenie_2.0.14_linux-arm64.zip
# Unzip the archive
unzip homegenie_2.0.14_linux-arm64.zip
2. Launch HomeGenie
Once you have extracted the archive, navigate into the created directory. You will find a homegenie subfolder (which contains the application itself) and a convenient startup script.
Simply run this script to start the server. The method varies slightly depending on your operating system:
Windows:
Double-click thestart.batfile.macOS:
Double-click thestart.commandfile. If prompted with a security warning, you may need to right-click the file and select "Open" the first time.Linux / Raspberry Pi:
Open a terminal in the folder and run:./start.sh
A new terminal window will open, displaying the HomeGenie server logs. To gracefully stop the application at any time, simply return to this terminal and press CTRL + C.
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.txtYou can change the port settings from the Settings > Maintenance page or by manually editing the systemconfig.xml file (while the service is stopped).
