# 🤓 What's up, Nerds? — Introducing Homey Self-Hosted Server

**URL:** <https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971>\
**Category:** Official Announcements\
**Tags:** announcement, homey-self-hosted\
**Created:** [December 15, 2025, 6:16pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971 "2025-12-15T18:16:08Z")\
**Posts on this page:** 20\
**Page:** 3

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [December 17, 2025, 12:17pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/41 "2025-12-17T12:17:48Z")

</div>

Thank you for the detailed explanation. That clears a few things up for me I think. So if I’ve understood correctly, if I’ve got a bunch of TBRs already (I have several HomePod Minis) then I can just ignore the Homey Thread network entirely and just add Matter over Thread devices to Homey using the “Connect via Android/ios” option and the devices should then be controllable by Homey via my existing Apple Thread network?

(And, to link this back to the topic, an SHS could potentially control Matter over Thread devices without the Bridge having Thread support, as long as the user already has a Thread network with TBR(s) and adds devices to Homey using that option).

---

<div class="post-metadata">

**Author:** ![danieldk](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/danieldk/32/121102_2.png) [@danieldk](https://community.homey.app/u/danieldk)\
**Post date:** [December 17, 2025, 12:48pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/42 "2025-12-17T12:48:18Z")

</div>

> [@Jonathan\_Draper](#):
>
> Thank you for the detailed explanation. That clears a few things up for me I think. So if I’ve understood correctly, if I’ve got a bunch of TBRs already (I have several HomePod Minis) then I can just ignore the Homey Thread network entirely and just add Matter over Thread devices to Homey using the “Connect via Android/ios” option and the devices should then be controllable by Homey via my existing Apple Thread network?

Indeed, that will add it to the Apple Thread network and the Homey Matter controller/server. If you _also_ want to expose the device to e.g. Apple Home, you can use the multi-admin feature to generate a QR code so that the device can also be added to Apple Home.

It also works the other way around, if you originally connected a device to e.g. the Apple Matter controller, you can get a QR code to link it to Homey.

> [@Jonathan\_Draper](#):
>
> And, to link this back to the topic, an SHS could potentially control Matter over Thread devices without the Bridge having Thread support, as long as the user already has a Thread network with TBR(s) and adds devices to Homey using that option

💯 This is the same way you can use e.g. Home Assistant Green without any dongles, just use an existing TBR. _A lot_ of people have one of these Google/Apple devices.

In principle it’s a really nice system, both Thread and Matter are kind of agnostic to the communication protocol and the network protocol respectively. E.g. over Thread you can do: Matter, ESPhome, or HomeKit as the communication protocol. And with Matter you can use WiFi and Thread as the network protocol. But it is _so easy_ to misconfigure. I have had the following issues so far:

- Initially I had a total mess. My idea was to have a separate Thread network for HA, ignoring the existing Apple and Homey networks. Device onboarding worked terribly - turned out that my iCloud Keychain had collected many credentials over the years and for probably the same reason added devices to the wrong network sometimes. In addition to that, HA and Apple had separate networks but ended up on the same channel (I learned that Apple always(?) uses channel 25). Which explains the onboarding flakiness + why devices dropped out all the time, etc.
- Then I cleared all my Thread credentials from iCloud Keychain, nuked the HA network, started over the HA Thread network on a different channel. This worked ok until somehow I or my iPhone managed to merge the Apple TBR into the HA Thread network. This also led to devices losing connection all the time, most likely due to the TBRs being part of the same network but having different channels.
- Finally, I started over once more and nuked everything and put the HA TBR on the same channel as the Apple TV again and put them on the same Thread network. So far, it has been stable.

I am not sure how a non-technical person would clean up this mess. Zigbee is so much simpler in that respect.

Annoyances I encountered along the way:

- You can disable the TBR on the Google TV Streamer (possibly other Google devices as well), but you cannot on Apple TV/HomePod. Even removing them from the Home app doesn’t disable the TBR itself. So only having a Homey or HA Thread network is just a dream. My advice is - if you have an Apple device with a TBR, just use that, or add it to the same network if you have an additional TBR like HA + dongle.
- You cannot disable the Zigbee/Thread radio on Homey Pro. This clutters a channel and it’s generally annoying to see it pop up in various places.
- AFAIK you cannot change the Homey Zigbee channel, except by resetting the Zigbee network on the developer site and cross your fingers that it picks a better channel this time.
- Completely at the beginning, I used Homey as a TBR, but it was not very stable. Probably because I already use a bunch of Zigbee devices and it’s a single radio.

---

<div class="post-metadata">

**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 17, 2025, 1:02pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/43 "2025-12-17T13:02:55Z")

</div>

> [@danieldk](#):
>
> I have had the following issues so far:

I’m running into many of the same issues at this moment right now. I have an SMHUB with Thread radio and OTBR, but that has never worked properly. I’ve also use a Docker container for hass-otbr that uses said radio over the network, which _somewhat_ worked, in that I as able to successfully pair an ESP32-H2 with it.

However, pairing my Nuki lock keeps on failing. I’ve paired it with my HomePod before, so it should work, but not with my preferred network.

I’ll try and see if I can set it up the same way that you have.

---

<div class="post-metadata">

**Author:** ![James\_Butler](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/james_butler/32/93836_2.png) [@James\_Butler](https://community.homey.app/u/James_Butler)\
**Post date:** [December 17, 2025, 1:26pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/44 "2025-12-17T13:26:26Z")

</div>

connecting devices, yes.. but becoming a member of an already existing thread network no

> Due to this shared hardware, Homey Pro currently can’t join an existing Thread network (such as one created by Apple Home or Google Home), as it may conflict with Homey Pro’s Zigbee network.

that’s what i meant

---

<div class="post-metadata">

**Author:** ![Henk\_Renting](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/henk_renting/32/87634_2.png) [@Henk\_Renting](https://community.homey.app/u/Henk_Renting)\
**Post date:** [December 17, 2025, 2:59pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/45 "2025-12-17T14:59:12Z")

</div>

![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/7/c7ca6b533baa901d46cf71b11552bdc0d08fa5f0.png)  
Almost there… 😉

---

<div class="post-metadata">

**Author:** ![martijnpieters](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/martijnpieters/32/35755_2.png) [@martijnpieters](https://community.homey.app/u/martijnpieters)\
**Post date:** [December 17, 2025, 3:04pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/46 "2025-12-17T15:04:16Z")

</div>

There it is: [Homey Self-Hosted Server – Run Homey on your hardware](https://homey.app/en-nl/homey-self-hosted-server/)

 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/7/c7adc1144348320c7bd0a99a6374d8433bd705a1.jpeg)

---

<div class="post-metadata">

**Author:** ![James\_Butler](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/james_butler/32/93836_2.png) [@James\_Butler](https://community.homey.app/u/James_Butler)\
**Post date:** [December 17, 2025, 3:12pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/47 "2025-12-17T15:12:29Z")

</div>

so now i can run Homey Pro in a docker on a home assistent server 😁

---

<div class="post-metadata">

**Author:** ![Jeroen\_Tebbens](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jeroen_tebbens/32/62246_2.png) [@Jeroen\_Tebbens](https://community.homey.app/u/Jeroen_Tebbens)\
**Post date:** [December 17, 2025, 3:13pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/48 "2025-12-17T15:13:33Z")

</div>

Promox LXC container started 😂

---

<div class="post-metadata">

**Author:** ![Henk\_Bartels](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/henk_bartels/32/12762_2.png) [@Henk\_Bartels](https://community.homey.app/u/Henk_Bartels)\
**Post date:** [December 17, 2025, 3:13pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/49 "2025-12-17T15:13:40Z")

</div>

> **[Homey Self-Hosted Server – Draai Homey op je eigen hardware](https://homey.app/nl-nl/homey-self-hosted-server/)**

but you still need a Homey Bridge nd that does not support Matter/thread.

---

<div class="post-metadata">

**Author:** ![Doekse](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/doekse/32/109415_2.png) [@Doekse](https://community.homey.app/u/Doekse)\
**Post date:** [December 17, 2025, 3:13pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/50 "2025-12-17T15:13:40Z")

</div>

Here you go 😉

> **[GitHub - Doekse/addon-homeyshs: Run Homey Self-Hosted Server as a Home Assistant...](https://github.com/Doekse/addon-homeyshs)**
>
> Run Homey Self-Hosted Server as a Home Assistant add-on

---

<div class="post-metadata">

**Author:** ![James\_Butler](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/james_butler/32/93836_2.png) [@James\_Butler](https://community.homey.app/u/James_Butler)\
**Post date:** [December 17, 2025, 3:15pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/51 "2025-12-17T15:15:07Z")

</div>

Christmas is early this year .. this is awesome.. thanks!

---

<div class="post-metadata">

**Author:** ![Henk\_Renting](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/henk_renting/32/87634_2.png) [@Henk\_Renting](https://community.homey.app/u/Henk_Renting)\
**Post date:** [December 17, 2025, 3:15pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/52 "2025-12-17T15:15:38Z")

</div>

That’s it? Just this short video? No further explanation by Athom employees?

But: Got it!

 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/c/7/c73c0d005cfea77d229fb882c8b0c4aeda5b9765.png)

(had to update my Homey phone/tablet app to be able to add a SHS)

---

<div class="post-metadata">

**Author:** ![Doekse](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/doekse/32/109415_2.png) [@Doekse](https://community.homey.app/u/Doekse)\
**Post date:** [December 17, 2025, 3:18pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/53 "2025-12-17T15:18:03Z")

</div>

I’m here, what’s the question? 😉

---

<div class="post-metadata">

**Author:** ![smarthomesven](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/smarthomesven/32/79712_2.png) [@smarthomesven](https://community.homey.app/u/smarthomesven)\
**Post date:** [December 17, 2025, 3:18pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/54 "2025-12-17T15:18:34Z")

</div>

Looks great, will install it on my Raspberry Pi!

---

<div class="post-metadata">

**Author:** ![RonnyW](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ronnyw/32/10879_2.png) [@RonnyW](https://community.homey.app/u/RonnyW)\
**Post date:** [December 17, 2025, 3:19pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/55 "2025-12-17T15:19:16Z")

</div>

Go to [Homey Self-Hosted Server – Run Homey on your hardware](https://homey.app/en-gb/homey-self-hosted-server/#pick-platform)  
And click on your favorite system to get a manual 🙂

[![grafik](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/4/3/4385d430cabd0ec12162b7f691f01a884dde75a2.png)](https://homey.app/en-gb/homey-self-hosted-server/#pick-platform)

---

<div class="post-metadata">

**Author:** ![Mike\_de\_Vries](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mike_de_vries/32/109113_2.png) [@Mike\_de\_Vries](https://community.homey.app/u/Mike_de_Vries)\
**Post date:** [December 17, 2025, 3:21pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/56 "2025-12-17T15:21:23Z")

</div>

how to connect SHS to homey pro (using homey link) or is that not possible?

When trying it shows no devices and keep sending heartbeat

---

<div class="post-metadata">

**Author:** ![smarthomesven](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/smarthomesven/32/79712_2.png) [@smarthomesven](https://community.homey.app/u/smarthomesven)\
**Post date:** [December 17, 2025, 3:22pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/57 "2025-12-17T15:22:00Z")

</div>

Is there also a way to install it on the Pi via Docker, or is the SD image the only option? I’d like to run it on my Pi 4 which already runs some other stuff like a few NodeJS scripts

---

<div class="post-metadata">

**Author:** ![Doekse](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/doekse/32/109415_2.png) [@Doekse](https://community.homey.app/u/Doekse)\
**Post date:** [December 17, 2025, 3:22pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/58 "2025-12-17T15:22:25Z")

</div>

You can indeed simply add it via HomeyLink, just like Homey Pro with another Homey Pro

---

<div class="post-metadata">

**Author:** ![RonnyW](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ronnyw/32/10879_2.png) [@RonnyW](https://community.homey.app/u/RonnyW)\
**Post date:** [December 17, 2025, 3:22pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/59 "2025-12-17T15:22:55Z")

</div>

> [@smarthomesven](#):
>
> install it on the Pi via Docker,

Check the [Docker manual](https://support.homey.app/hc/en-us/articles/24010537261980-How-to-install-Homey-Self-Hosted-Server-with-Docker-on-Linux) and use the docker file.

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [December 17, 2025, 3:22pm UTC](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971/60 "2025-12-17T15:22:59Z")

</div>

> [@martijnpieters](#):
>
> [Homey Self-Hosted Server – Run Homey on your hardware](https://homey.app/en-nl/homey-self-hosted-server/)

Hi @Doekse

My question (linked to the discussion above): the SHS page says Thread is not supported by Homey SHS. But can I still add a Matter over Thread device to Homey SHS by using the “Connect via Android/iOS” option in the Homey mobile app and using existing Thread Border Routers (HomePod Minis in my case)?

 ![Screenshot 2025-12-17 at 15.20.34](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/a/8/a8c4b1f6de58218f2ba6068ff9c29705eb61a29d.jpeg)

[Previous page](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971.md?page=2)

[Next page](https://community.homey.app/t/whats-up-nerds-introducing-homey-self-hosted-server/146971.md?page=4)
