# Homey Self-Hosted Server on Linux | Megathread **URL:** \ **Category:** Homey Self-Hosted Server\ **Created:** [December 5, 2025, 2:11pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436 "2025-12-05T14:11:58Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![Emile](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/emile/32/115314_2.png) [@Emile](https://community.homey.app/u/Emile)\ **Post date:** [December 5, 2025, 2:11pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/1 "2025-12-05T14:11:58Z")
In this thread we can discuss running Homey Self-Hosted Server on Linux. **Installation** Learn how to [Install Homey Self-Hosted Server on Linux](https://support.homey.app/hc/en-us/articles/23975096785948-How-to-install-Homey-Self-Hosted-Server-on-Linux). **Known Limitations** None at this moment. ---
**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\ **Post date:** [December 18, 2025, 5:28am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/2 "2025-12-18T05:28:39Z")
> [@Emile](#): > > on Windows. Ehhh Winnux? Lidows? 😉 ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 19, 2025, 7:58pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/3 "2025-12-19T19:58:01Z")
Hello, I followed the instructions on how to start the docker image on my Ubuntu server. Then I opened my phone and serched for the server - it was there so I clicked it. After a few minutes the connection timed out with a message that I should check if the server is properly plugged in and has an active network connection (it has, because I have active SSH connection and remote desktop). I tried to open it in “My Homeys” tab but it shows this message: ![Screenshot 2025-12-19 at 20.56.02](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/5/c/5c8de4c0bd8d94a8a6dbe9cd75e9deb633a0ae6e.png) What should I do to fix this? I have checked the Firewall log for any blockages but nothing should be blocking it. ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 19, 2025, 8:11pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/4 "2025-12-19T20:11:35Z")
Turns out it was blocking some ports. I have allowed the 4859 port and it works without any problems! 😃 ---
**Author:** ![Vibs](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/vibs/32/123721_2.png) [@Vibs](https://community.homey.app/u/Vibs)\ **Post date:** [December 21, 2025, 12:32am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/5 "2025-12-21T00:32:49Z")
I installed Homey SHS in Docker on my Raspberry Pi 5. Now I am trying to connect Bluetooth devices, specifically a BLE water leak sensor from Switchbot. I get a message saying that I need the Homey Bridge for this. Shouldn’t it be possible to connect this type of device via the Pi’s built in bluetooth module? If so how can I achieve this? From my research on the web I understand that I need to make bluetooth available in Docker, but I honestly don’t understand how to achieve this (I am a total newbie when it comes to Pi OS and Docker). ---
**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\ **Post date:** [December 21, 2025, 1:13am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/6 "2025-12-21T01:13:27Z")
As it might be technically possible, at the moment you’ll just need a Homey bridge, an other Pro, or something like an SMlight/-hub. ---
**Author:** ![Geert\_Janssens](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/geert_janssens/32/124164_2.png) [@Geert\_Janssens](https://community.homey.app/u/Geert_Janssens)\ **Post date:** [December 21, 2025, 8:16pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/7 "2025-12-21T20:16:25Z")
Hi, successfully installed self hosted server on a mini pc, bought the homey Bridge, and started to add mostly Zigbee devices. The first 5 working perfectly… but as the number of devices gets bigger , towards 20, the lag, is really getting so long. Or sometimes a device simply not available. Only after trying 5-10 times to switch on or off, the device will do… Is this something due to something i do wrong? Please advise. Sincerely, ---
**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\ **Post date:** [December 21, 2025, 10:28pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/8 "2025-12-21T22:28:35Z")
Did you take interference into account? (You can skip the hints for a Homey Pro, like power adapters) > [@Advanced Zigbee Troubleshooting on Homey](https://community.homey.app/t/advanced-zigbee-troubleshooting-on-homey/115930): > > If you’re experiencing issues with your Zigbee network on Homey, here are advanced troubleshooting steps to help optimize performance and stability, especially in more complex environments: Power Supply Integrity A stable power supply is critical for Homey’s performance. An underpowered adapter can lead to instability in the Zigbee network. Always ensure you’re using a reliable adapter providing at least 2A. Power fluctuations can cause disconnections or communication failures, especially un… Zigbee-over-wifi is not something I’d want. Now your wifi connection add it’s own layer of possible issues when it comes to reliable data transmission. ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 23, 2025, 9:04am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/9 "2025-12-23T09:04:23Z")
Hello, I have bought the Sonoff Dongle Max to support Thread on my SHS, but I can’t seem to get it working. I want to use the OpenTjread Border Router on my Ubuntu server with Homey, but it always fails. Did somebody het it to work? If so, could you please tell me how? Edit: The dongle is connected through WiFi and connected to the server via USB. Here is part of the log: ```auto s6-rc: info: service s6rc-oneshot-runner: starting s6-rc: info: service s6rc-oneshot-runner successfully started s6-rc: info: service fix-attrs: starting s6-rc: info: service fix-attrs successfully started s6-rc: info: service legacy-cont-init: starting s6-rc: info: service legacy-cont-init successfully started s6-rc: info: service otbr-agent: starting Configuring OpenThread firewall... Configuring OpenThread NAT64... Starting otbr-agent... [NOTE]-AGENT---: Running 0.3.0-afd7593 [NOTE]-AGENT---: Thread version: 1.4.0 [NOTE]-AGENT---: Thread interface: wpan0 [NOTE]-AGENT---: Radio URL: /dev/ttyUSB0 [NOTE]-AGENT---: Radio URL: trel://enp1s0f0 [NOTE]-ILS-----: Infra link selected: enp1s0f0 [INFO]-RCP_HOS-: OpenThread log level changed to 5 50d.07:34:44.573 [C] Platform------: Init() at radio_url.cpp:153: Failure otbr-agent exited with code 1 (by signal 0). Chain OT_FORWARD_INGRESS (0 references) target prot opt source destination DROP all -- anywhere anywhere PKTTYPE = unicast DROP all -- anywhere anywhere match-set otbr-ingress-deny-src src ACCEPT all -- anywhere anywhere match-set otbr-ingress-allow-dst dst DROP all -- anywhere anywhere PKTTYPE = unicast ACCEPT all -- anywhere anywhere otbr-ingress-deny-src otbr-ingress-deny-src-swap otbr-ingress-allow-dst otbr-ingress-allow-dst-swap OpenThread firewall rules removed. s6-svlisten1: fatal: /run/s6-rc/servicedirs/otbr-agent failed permanently or its supervisor died s6-rc: warning: unable to start service otbr-agent: command exited 1 s6-rc: info: service legacy-cont-init: stopping s6-rc: info: service legacy-cont-init successfully stopped s6-rc: info: service fix-attrs: stopping s6-rc: info: service fix-attrs successfully stopped s6-rc: info: service s6rc-oneshot-runner: stopping s6-rc: info: service s6rc-oneshot-runner successfully stopped ``` ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [December 23, 2025, 9:13am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/10 "2025-12-23T09:13:59Z")
> [@Petr\_Pavlik](#): > > I want to use the OpenTjread Border Router on my Ubuntu server with Homey, but it always fails. Did somebody het it to work? If so, could you please tell me how? I feel that asking generic Linux questions like this is off-topic for this forum (even though your goal is to _eventually_ get it working with Homey SHS, you’re basically asking how to set up OTBR on Ubuntu, and there are probably better forums to ask this on). ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 23, 2025, 11:02am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/11 "2025-12-23T11:02:23Z")
I thought that there might be some better solutions or something specific to do for Homey. Home assistant has its own extension, so I thought that it needs something custom as well. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [December 23, 2025, 12:06pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/12 "2025-12-23T12:06:56Z")
If you _have_ something specific for Homey to present, that would be great, but like I said, I feel that asking questions about setting up OTBR are off-topic for this forum. Otherwise, people might get the idea that asking general Linux questions (“How do I install Linux so I can run Homey SHS?”) would be okay here too. ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 23, 2025, 12:20pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/13 "2025-12-23T12:20:50Z")
Like I said, I thought that there are some better solutions or tweaks that have to be done so that I wouldn’t have to do it the standard Docker way. I asked if someone did get it to work on SHS, so I think that it’s appropriate question. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [December 23, 2025, 12:43pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/14 "2025-12-23T12:43:47Z")
> [@Petr\_Pavlik](#): > > I want to use the OpenTjread Border Router on my Ubuntu server with Homey You literally asked “_I want to use the OpenTjread Border Router on my Ubuntu server with Homey_”, and then show that you cannot get the OTBR to work and need help with that 🤷🏼‍♂️ Getting OTBR to work with your specific hardware is off-topic here. ---
**Author:** ![Petr\_Pavlik](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petr_pavlik/32/121441_2.png) [@Petr\_Pavlik](https://community.homey.app/u/Petr_Pavlik)\ **Post date:** [December 23, 2025, 3:05pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/15 "2025-12-23T15:05:58Z")
I literally asked how to make it work with Homey. To prevent questions like “send me the log or send us more info” I sent a log because I thought that somebody may say that I do it the wrong way and that I should use some sort of a plugin or other app to make it work with Homey. I asked on a Linux thread about using something with Homey, so I think that is appropriate. I just wanted to know if somebody did it as well, so they could tell me what is wrong. Please don’t always cite my previous sentences, you just repeat everything. This could have ended by you responding to my first answer something like “Oh, okay” 🤷‍♂️ ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [December 23, 2025, 3:10pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/16 "2025-12-23T15:10:46Z")
Ah okay, if you’re asking how to make it work with Homey, my answer would be: get OTBR to start properly first. How to do that is off-topic for this forum. ---
**Author:** ![Mike\_Roher](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mike_roher/32/79538_2.png) [@Mike\_Roher](https://community.homey.app/u/Mike_Roher)\ **Post date:** [January 23, 2026, 8:22am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/18 "2026-01-23T08:22:27Z")
I followed the instructions on how to update [Self-Hosted-Service on Linux](https://support.homey.app/hc/en-us/articles/23975096785948-How-to-install-Homey-Self-Hosted-Server-on-Linux) and now my old “Self-Hosted-Homey” is delete an make as a new SHS?! No Backup, nothing, the description is not correct. I have e new system without any devices, apps etc. this not an update. Anyone know what is going wrong? Greetings ---
**Author:** ![bjornb](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/bjornb/32/17214_2.png) [@bjornb](https://community.homey.app/u/bjornb)\ **Post date:** [January 23, 2026, 9:12am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/19 "2026-01-23T09:12:16Z")
I did not do the remove, just docker pull (as mentioned in the instruction) and docker compose down and then up. Seems to be running fine on the new version ---
**Author:** ![Mike\_Roher](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mike_roher/32/79538_2.png) [@Mike\_Roher](https://community.homey.app/u/Mike_Roher)\ **Post date:** [January 23, 2026, 9:17am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/20 "2026-01-23T09:17:23Z")
ok thank you maybe Athom Homey should change that in her description. but for me its to late 🤷‍♂️ ---
**Author:** ![bjornb](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/bjornb/32/17214_2.png) [@bjornb](https://community.homey.app/u/bjornb)\ **Post date:** [January 23, 2026, 9:18am UTC](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436/21 "2026-01-23T09:18:40Z")
It may be slightly different when using docker compose, I see the update instructions are different there. [Next page](https://community.homey.app/t/homey-self-hosted-server-on-linux-megathread/146436.md?page=2)