Homebridge is a lightweight NodeJS server you can run on your home network that emulates the iOS HomeKit API. Homebridge allows you to integrate with smart home devices that do not support the HomeKit protocol. After installing Homebridge, it remains running and connected to your network, ready to service requests from Siri. In this step by step guide I will show you how to install Homebridge on your UGREEN NAS using Docker. You can also use Home Assistant for your smart home devices.

💡Note: This guide works perfectly with the latest Homebridge v1.8.5 release.

💡Note: Check out my new guide on how to Install Homebridge on Your Synology NAS.

• STEP 1

Please Support My work by Making a Donation.

• STEP 2

Install Portainer using my step by step guide. If you already have Portainer installed on your UGREEN NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.

• STEP 3

Add Read & Write Permissions to the Docker Folder. If you have already added the Read and Write Permissions to the Docker Folder, skip this STEP.

• STEP 4

Go to File Manger and open the docker folder. Inside the docker folder, create one new folder and name it homebridge. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.

• STEP 5

Log into Portainer using your username and password. On the left sidebar in Portainer, click on Stacks then + Add stack. Follow the instructions in the image below.

• STEP 6

In the Name field type in homebridge. Follow the instructions in the image below.

Note: Copy Paste the code below in the Portainer Stacks Web editor.

version: '3.9'
services:
  homebridge:
    image: homebridge/homebridge
    container_name: Homebridge
    healthcheck:
     test: curl -f http://localhost:8581/ || exit 1
    mem_limit: 8g
    cpu_shares: 768
    security_opt:
      - no-new-privileges:true
    restart: on-failure:5
    volumes:
      - /volume1/docker/homebridge:/homebridge:rw
    environment:
      - TZ=Europe/Bucharest
      - PACKAGES=ffmpeg
    network_mode: host

Note: Before you paste the code above in the Web editor area below, change the value for TZ. (Select your current Time Zone from this list.)

• STEP 7

Scroll down on the page until you see a button named Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.

• STEP 8

If everything goes right, you will see the following message at the top right of your screen: “Success Stack successfully deployed“.

• STEP 9

Go back to STEP 1 or you will deal with karma 🙂

• STEP 10

The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type in http://ugreennas-ip-address:8581 Click GET STARTED. Follow the instructions in the image below.

• STEP 11

Type in your own credentials (Username and Password) then click CREATE ACCOUNT. Follow the instructions in the image below.

• STEP 12

Click OPEN DASHBOARD. Follow the instructions in the image below.

• STEP 13

Your Homebridge dashboard at a glance! Enjoy HomeBridge and start adding Plugins.

• STEP 14

If you want to add FFmpeg, click the Plugins tab, then search for ffmpeg. Click the Install icon to Install Homebridge Camera Ffmpeg. Follow the instructions in the image below.

• STEP 15

Select the latest version, then click INSTALL. Follow the instructions in the image below.

• STEP 16

The plugin is now successfully installed. Follow the instructions in the image below.

• STEP 17

At the top right of the page, click on the 3 vertical lines then UI Settings icon. Select your favorite Homebridge theme, then click SAVE to save the settings. Follow the instructions in the image below.

Enjoy Homebridge on your UGREEN NAS!

This post was updated on Wednesday / December 11th, 2024 at 3:47 PM