Homey Self-Hosted Server can be easily installed on TrueNAS, an operating system designed for Network Attached Storage (NAS) devices.
Installing Homey Self-Hosted Server
1. Open TrueNAS
Open the TrueNAS Web UI in your web browser.
2. Configure Multicast DNS
Navigate to System → Network
Under Network Configuration, click Settings. Uncheck mDNS and click Save.
TrueNAS prevents other application from advertising Multicast DNS while this is checked. Homey Self-Hosted Server requires mDNS to work.
3. Create an App
Navigate to Apps → Discover Apps and click Custom App.
- Under Application Name, enter
homey-shs. - Under Image Configuration → Repository, enter
ghcr.io/athombv/homey-shs. - Under Container Configuration → Hostname, enter
homey-shs. - Under Container Configuration → Restart Policy, select Unless Stopped.
- Under Security Context Configuration, check Privileged.
- Under Network Configuration, check Host Network.
- Under Storage Configuration → Storage, click Add.
- Under Mount Path, enter
/homey/user/.
Finally, click Install.
4. Continue on iPhone & Android
Open the Homey app for iOS or Android to add a new Homey, and select Self-Hosted Server.
Updating Homey Self-Hosted Server
1. Open TrueNAS
Open the TrueNAS Web UI in your web browser.
2. Pull latest Image
Navigate to Apps → Configuration → Manage Container Images. Then click Pull Image.
Under Image Name, enter ghcr.io/athombv/homey-shs, and click Save.
Navigate to Apps → homey-shs and click Edit, immediately followed by clicking Update.
Creating a Backup
To create a backup, copy the files & folders in the directory that's mounted into the app.
You can find this path under Apps → homey-shs and click the folder-icon with the label Volume Mounts. The value shown there is something similar to /mnt/.ix-apps/app_mounts/homey-shs/storage_entry.
To restore a backup, put them back before starting Homey Self-Hosted Server.
Help & Troubleshooting
If you're stuck and need help, head over to the Homey Community Forum.
