How to install eufy-security-ws on Unraid

This guide will show you how you to install eufy-security-ws on an Unraid server. This app is needed to integrate Eufy cameras with Home Assistant.

Disclosure: This post contains affiliate links. If you click through and make a purchase, I’ll earn a commission, at no additional cost to you. Read my full disclosure here.
Two security cameras (CCTV) mounted on opposing walls

If you want to integrate your Eufy security cameras and doorbells with the popular open-source home automation application Home Assistant, you will quickly find that one of the components isn’t readily available for Unraid: The server wrapper around the eufy-security-client library called eufy-security-ws. The difficulty of installing this application is related to the fact that there isn’t any template available in the Community Applications.

Although the installation isn’t quite as easy as with other applications, this shouldn’t be a hindrance, as there is an official Docker container available. This guide will show you in detail how you can install eufy-security-ws on your Unraid server. While the steps aren’t quite as simple as adding a pre-made template, I am confident that any Unraid user should be capable of following them.

Enabling Docker Hub search results on Unraid

As the eufy-security-ws Docker container is available on Docker Hub but not in the Community Applications, you will need to enable the option to display search results from Docker Hub in the latter’s settings.

To do so, simply select the Settings link and beneath the categories on the left-hand side you will see a link to the settings. In the settings, you need to enable the option titled “Enable additional search results from dockherHub [sic]” by changing it from No to Yes.

The setting to enable Docker Hub search results in the Unraid Community Applications
A message saying the eufy-security-ws Docker container couldn't be found in the Unraid Community Applications

Next, head back in to the Community Applications and search for bropat/eufy-security-ws (that is the container’s exact name from Docker Hub). Unless someone has added a template for the application since publishing this guide, you will be greeted by a message informing you that no matching applications were found. Here you will have to click on the option to get more search results from Docker Hub.

The correct Docker container should be found. Make sure the container comes from the developer who calls themselves bropat. Click on the install-icon to continue.

The eufy-security-ws Docker container in the Unraid Community Applications search results

Configuring the eufy-security-ws Docker container

The settings already present, for example the network type and Docker Hub URL, can be left as they are. What you will have to do is map a port and persistent directory, and configure a few variables. The options available can be found in the GitHub repository. Required are the username and password, the port, and the persistent directory.

The eufy-security-ws Docker container being configured on Unraid
A variable being added to the eufy-security-ws container on Unraid

On Unraid, The username and password must be added as variables, the port as a port, and the persistent directory as a path. For the latter, I recommend the host path /mnt/user/appdata/eufy-security-ws. I mapped the container’s port to the host port 3002, as port 3000 was already taken. The final configuration should look similar to the one in the screenshot below.

With everything configured, you can hit the apply button and the Docker container will be pulled and configured using the options you added. To make sure everything is running as it should be, you can click on the application’s icon in the Docker tab and view the logs. In the logs, you should be seeing the following message: Push notification connection successfully established.

The full configuration for the Docker container eufy-security-ws on Unraid

Changing a Docker applications icon on Unraid

One last thing you might want to do is to change the application’s icon from the question mark to something more recognizable. To do so, open up the eufy-security-ws container’s settings by clicking on its name and look for the icon URL text field. You can add any local file or use an icon you found online, for example by googling “eufy logo”. Paste the path or URL in to the field and apply the changes to have the new icon displayed.

The eufy logo being displayed on the eufy-security-ws Docker container on Unraid

About Liam Alexander Colman

I first heard of Unraid through the same medium as many of us did: The Linus Tech Tips channel on YouTube. At the time, I was running TrueNAS (or FreeNAS as it was called back then) on my DIY NAS built using a dual-core Intel Pentium G4400 at its heart. I was convinced, I had chosen the better operating system. After all, it was free and open-source and had a large community behind it. One day, after once again facing the need to buy another three hard drives, I seriously started researching Unraid and its features. I bit the bullet and gave it a go, transferring my data on to external hard drives that I later shucked and added to the Unraid array. Since that day, I have not looked back once, and I am now an enthusiastic and experienced user of Unraid. You can find out more about Unraid Guides right here.

Leave a comment