How to install Homey Self-Hosted Server on Synology

System Requirements

• A Synology NAS with an Intel/AMD CPU, running DSM 7.2 or newer.
• At least 1 GB of free RAM.
• At least 2 GB of free storage.

Installing Homey Self-Hosted Server

1. Install Container Manager

Make sure you have Container Manager installed from Package Center.

2. Create a Project in Container Manager

Open Container Manager, navigate to Project and click Create.

Under Project name, enter homey-shs.

Under Path, select a directory where you'd like to save the userdata. In this example, we created a Shared Folder named Homey Self-Hosted Server.

Under Source, select Create docker-compose.yml.

Then copy & paste the following text.

services:
  homey-shs:
    image: ghcr.io/athombv/homey-shs:latest
    container_name: homey-shs
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - ./:/homey/user

3. Starting the Container

Click Next. In Web portal settings, change nothing and click Next.

In the Summary screen, ensure that Start the project once it is created is checked, and click Done.

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

To update Homey Self-Hosted Server, open Container Manager, navigate to Project.

Right-click on homey-shs, and select Clean.

Navigate to Image, right-click on ghcr.io/athombv/homey-shs:latest and click Delete.

Go back to Project, right-click on homey-shs and click Build.

Homey Self-Hosted Server is now updated to the latest version.

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.