Self-host HomeGenie

Download the .zip archive corresponding to your operating system, architecture, and hardware acceleration needs, then unzip the archive to your preferred location.

Simply run the startup script to launch the server:

• Windows: Double-click start.bat
• macOS: Double-click start.command
• Linux / Raspberry Pi: Run ./start.sh from the terminal (or double-click if your file manager supports executing shell scripts).

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

Open a Command Prompt as an Administrator, navigate to the homegenie directory, and run:

HomeGenie.exe --service install
HomeGenie.exe --service start

1. (Recommended) Create a dedicated user for the service and move the application files:

   # Create a new system user named 'homegenie' with its home directory
   sudo useradd -r -m -s /bin/false homegenie
   
   # Copy the application files into the new home directory
   # Assumes you are in the directory where you extracted the zip
   sudo cp -ar ./homegenie/* /home/homegenie/
   
   # Ensure the ownership of all files is correct
   sudo chown -R homegenie:homegenie /home/homegenie
   

2. Create a service definition file at /etc/systemd/system/homegenie.service:

   [Unit]
   Description=HomeGenie Automation Server
   After=network.target
   
   [Service]
   Type=notify
   User=homegenie
   Group=homegenie
   WorkingDirectory=/home/homegenie/
   ExecStart=/home/homegenie/HomeGenie
   Restart=on-failure
   RestartSec=15s
   
   [Install]
   WantedBy=multi-user.target
   

3. Reload the systemd daemon, then start and enable the service:

   sudo systemctl daemon-reload
   sudo systemctl start homegenie.service
   sudo systemctl enable homegenie.service