System Requirements
- An Unraid installation with a 64-bit Intel/AMD CPU.
- At least 1 GB of free RAM.
- At least 2 GB of free storage.
Installing Homey Self-Hosted Server
1. Creating a Docker Container
To update Homey Self-Hosted Server, sign in to Unraid and navigate to Docker.
Click Add container on the bottom-left.
If you don't see a Docker tab, go to Settings → Docker and set Enable Docker to Yes.
2. Fill out the details
First, click the toggle next to Basic View, to switch to Advanced View.
- Under Name, enter
homey-shs. - Under Repository, enter
ghcr.io/athombv/homey-shs:latest. - Under Icon URL, enter
https://etc.athom.com/logo/transparent/1024.png. - Under WebUI, enter
http://[IP]:[PORT:4859]. - Set Network Type to Host.
- Set Privileged to On.
Click Add another Path, Port, Variable, Label or Device, and make sure that Config Type is set to Path.
- Under Container Path, enter
/homey/user. - Under Host Path, enter
/mnt/user/appdata/homey-shs. You can choose another path for your Homey Self-Hosted Server's userdata, if you like. - Make sure that Access Mode is set to Read/Write.
Click Add to add the shared folder.
Finally, when you're back in the previous screen, click Apply.
Homey Self-Hosted Server will now start. You can click View Container Log to check if everything looks good.
3. 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
To update Homey Self-Hosted Server, open Unraid and navigate to Docker.
Click Check for Updates. Your containers will be updated automatically.
Creating a Backup
To create a backup, copy the files & folders in the path you selected during installation, e.g. /mnt/user/appdata/homey-shs, to a safe location.
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.
