System Requirements
- A QNAP NAS with an Intel/AMD or Arm64 CPU, running the latest firmware.
- At least 1 GB of free RAM.
- At least 2 GB of free storage.
Installing Homey Self-Hosted Server
1. Install Container Station
In App Center, search for Container Station and install the app.
2. Open Container Station
Open Container Station, then click Containers.
3. Create a Container
- Click Create. Set Mode to Advanced mode.
- Keep Image type to Docker image.
- Set Image to
ghcr.io/athombv/homey-shs:latest. - Check Try pulling the image from the registry before creating the container.
- Click Next.
4. Advanced Settings
In the next screen, set Name to homey-shs, and Restart policy to Unless Stopped.
Then click Advanced Settings.
Under Networks, select Custom and set the dropdown to Bridge.
Under Hostname, enter homey-shs.
Under Storage, click the ▼-icon on the right of Add Volume, and click Bind Mount Host Path.
Under Host, select a folder where you'd like to store your data. In this example, we created a folder called Homey Self-Hosted Server.
Under Container, enter /homey/user.
Under Runtime, enable Privileged mode.
Click Apply.
5. Finishing up
Click Next, then click Finish.
Your Homey Self-Hosted Server container will now start automatically.
Once you see Homey Self-Hosted Server is ready to be activated! in the terminal, you can continue.
6. 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 Container Station and navigate to Containers.
Find the container named homey-shs, and click on the gear icon in the Actions column.
Click Recreate Directly, and check Try pulling the image from the registry before creating the container. Finally, click OK.
Your container will now be updated to the latest version automatically.
Creating a Backup
To create a backup, copy the files & folders in the path you selected during installation, e.g. /Homey Self-Hosted Server, 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.