# Homey Self-Hosted Server on macOS | Megathread

**URL:** <https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435>\
**Category:** Homey Self-Hosted Server\
**Created:** [December 5, 2025, 2:11pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435 "2025-12-05T14:11:26Z")\
**Posts on this page:** 20\
**Page:** 5

<div class="post-metadata">

**Author:** ![scull122](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/scull122/32/80323_2.png) [@scull122](https://community.homey.app/u/scull122)\
**Post date:** [March 15, 2026, 7:05pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/81 "2026-03-15T19:05:12Z")

</div>

I am not. I do have Google home but to be honest, I don’t use it much.

---

<div class="post-metadata">

**Author:** ![JMDPC](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jmdpc/32/121098_2.png) [@JMDPC](https://community.homey.app/u/JMDPC)\
**Post date:** [March 15, 2026, 8:29pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/82 "2026-03-15T20:29:15Z")

</div>

OK I had some device paired to apple home and some to my Aqara hub, once they were paired to my Apple Thread network everything worked

---

<div class="post-metadata">

**Author:** ![Paul\_Elder](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/paul_elder/32/124340_2.png) [@Paul\_Elder](https://community.homey.app/u/Paul_Elder)\
**Post date:** [May 18, 2026, 10:26pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/83 "2026-05-18T22:26:07Z")

</div>

I have managed to install docker and have homey running in docker. When I go to the homey app it can’t find the ip address of the self hosted server. Docker has a different ip address than my Mac? Do I need to change a setting in docker

---

<div class="post-metadata">

**Author:** ![Marc\_Jurriens](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/marc_jurriens/32/11951_2.png) [@Marc\_Jurriens](https://community.homey.app/u/Marc_Jurriens)\
**Post date:** [May 19, 2026, 4:39am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/84 "2026-05-19T04:39:19Z")

</div>

That depends on how you setup your docker.. ip could be shared with the host or could have its own… If you go into the console of the docker you could do an ifconfig to see what it is…

If that all is unknown then we need to get you the commands but honoustly: in that case think about if shs is the way for you…

---

<div class="post-metadata">

**Author:** ![Paul\_Elder](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/paul_elder/32/124340_2.png) [@Paul\_Elder](https://community.homey.app/u/Paul_Elder)\
**Post date:** [May 19, 2026, 10:30am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/85 "2026-05-19T10:30:37Z")

</div>

Hi Marc

Forgive my lack of knowledge, I have never used docker and this is the first time, can you tell me how to do the ifconfig in docker. I have managed to do the plex server, sonnarr, raddarr and liddar on the mac, with a little guidance im pretty sure i can get this working as well 🙂

---

<div class="post-metadata">

**Author:** ![Anoniemand](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/anoniemand/32/120697_2.png) [@Anoniemand](https://community.homey.app/u/Anoniemand)\
**Post date:** [May 19, 2026, 10:54am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/86 "2026-05-19T10:54:18Z")

</div>

Interesting. I hope you do note that Homey SHS is considered a DIY solution and your current setup isn’t among the known setups for Homey Self Hosted Server. For Mac OS there is an app that you can use, but you chose to manually run the docker container on MacOS, so the known setup “Docker on Linux” might come closest.

Please be aware that support for this specific installation (also from the Community) can get quite complicated. To try out Homey SHS, that might work. But think again before you start setting things up and start “depending” on it.

To start: How did you install? Do you use a docker compose file? what’s the content?

---

<div class="post-metadata">

**Author:** ![Paul\_Elder](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/paul_elder/32/124340_2.png) [@Paul\_Elder](https://community.homey.app/u/Paul_Elder)\
**Post date:** [May 19, 2026, 11:47am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/87 "2026-05-19T11:47:51Z")

</div>

Hi

The reason I’m using docker is that I have a Mac with an intel chip which can’t run the homey app. The only way I can run this is via docker. I have run the command in terminal and appears to be working. I will need to wait till I get home tonight to see if I can connect to server with my phone, fingers crossed.

---

<div class="post-metadata">

**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:** [May 19, 2026, 1:18pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/88 "2026-05-19T13:18:24Z")

</div>

If it’s up and running you can reach it per [https://my.homey.app](https://my.homey.app) as well, Paul, but only if you accessed it per mobile app at least once, for HSHS to have it registered.  
Both interfaces can access Homeys from anywhere.

 ![Screenshot20260519152037Ecosia](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/5/c/5c8df8f3252fd3aa6577c786ddfab748f8bc580e.jpeg)

---

<div class="post-metadata">

**Author:** ![Paul\_Elder](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/paul_elder/32/124340_2.png) [@Paul\_Elder](https://community.homey.app/u/Paul_Elder)\
**Post date:** [May 19, 2026, 3:35pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/89 "2026-05-19T15:35:03Z")

</div>

Hi Peter

I appreciate the quick reply, it’s telling me it up and running, once I’m back home later on tonight fingers crossed, when I go to the homey app on my phone, it will connect this time 🙂

---

<div class="post-metadata">

**Author:** ![zm.miska](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/zm.miska/32/120752_2.png) [@zm.miska](https://community.homey.app/u/zm.miska)\
**Post date:** [May 25, 2026, 9:13pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/90 "2026-05-25T21:13:50Z")

</div>

Hi, new to Homey. Trying the 1 moth free self hosted on a Mac mini M4 with the latest macOS.The Homey app stays open in the menu bar, but after some time the iPhone app cant reach the self hosted homey when I’m away from home. As soon as I return home and log into the Mac, Homey immediately becomes reachable again. Is Homey Self-Hosted on macOS supposed to work fully in the background with the session locked, or does it currently depend on an active user session?

---

<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:** [May 26, 2026, 5:01am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/91 "2026-05-26T05:01:22Z")

</div>

> [@zm.miska](#):
>
> …or does it currently depend on an active user session?

Here’s an easy test: log out from your Mac and check if it still works. Then check if it still works after 15 minutes or so. If it still works, then no, it doesn’t depend on an active user session.

---

<div class="post-metadata">

**Author:** ![zm.miska](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/zm.miska/32/120752_2.png) [@zm.miska](https://community.homey.app/u/zm.miska)\
**Post date:** [May 26, 2026, 10:27pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/92 "2026-05-26T22:27:51Z")

</div>

I tested it.

When I quit the Homey Self-Hosted Server app, Homey immediately goes offline, both on Wi-Fi and mobile data.

I also tried logging out of macOS, not just locking the screen. Homey went offline as well.

So it seems that, at least on my Mac, Homey Self-Hosted only works while the app is running inside an active macOS user session. It does not seem to run as a background daemon/service after logout.

Is this expected behaviour?

---

<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:** [May 27, 2026, 4:58am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/93 "2026-05-27T04:58:34Z")

</div>

> [@zm.miska](#):
>
> Is this expected behaviour?

If you quit an application, either directly (by quitting it) or by logging out (which stops all your active applications), then I would think it’s expected, yes. Locking the screen will keep your applications, including the Homey app, running.

It _would_ make more sense to run as some sort of background process, but I’m sure that has been considered and dismissed for some reason.

---

<div class="post-metadata">

**Author:** ![Jason\_Jackson1](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jason_jackson1/32/169158_2.png) [@Jason\_Jackson1](https://community.homey.app/u/Jason_Jackson1)\
**Post date:** [August 4, 2026, 7:08am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/94 "2026-08-04T07:08:11Z")

</div>

Did you find a work around as im having the same issues with my mac mini, itll work fine but i normaly just turn the tv off that its connected to i dont lock it and after a period of time Homey stops working and i have to restart the mac for it to work again.

I take it that after a number of hours the mac shust something down ive also noticed when i restart the mac my amazon devices no longer work and i have to re authorise them

---

<div class="post-metadata">

**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:** [August 4, 2026, 9:13am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/95 "2026-08-04T09:13:43Z")

</div>

Sounds like some energy saving setting kicking in @ MAC. Try to disable anything related, because your MAC is now operating as a 24/7 server

---

<div class="post-metadata">

**Author:** ![Jason\_Jackson1](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jason_jackson1/32/169158_2.png) [@Jason\_Jackson1](https://community.homey.app/u/Jason_Jackson1)\
**Post date:** [August 4, 2026, 9:40am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/96 "2026-08-04T09:40:19Z")

</div>

ive changed a few settings so hopefully its now sorted

---

<div class="post-metadata">

**Author:** ![Jason\_Jackson1](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jason_jackson1/32/169158_2.png) [@Jason\_Jackson1](https://community.homey.app/u/Jason_Jackson1)\
**Post date:** [August 13, 2026, 7:59pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/97 "2026-08-13T19:59:43Z")

</div>

I’m running homey server on a mac mini and i have an issue were randomly it will stop working ive change the setting in ios so the mac dosnt lock but every not and then it stops working and i have to reboot Homey im struggling to find the issue something i did notice and it might not be anything but when i look at the server settings in homey the time is an hour out to the mac click, could this cause the issue??

---

<div class="post-metadata">

**Author:** ![staeff](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/staeff/32/79712_2.png) [@staeff](https://community.homey.app/u/staeff)\
**Post date:** [August 31, 2026, 7:39am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/98 "2026-08-31T07:39:43Z")

</div>

@Emile are you aware of potential issues when running python apps on SHS for macOS? I’ve had a few reports of users not being able to use Python apps on SHS before. But usually this can be fixed by running the container in privileged mode. But for the macOS runner there is no obvious option to enable it. Overall this requirement of python on SHS is not really documented anywhere.

---

<div class="post-metadata">

**Author:** ![Daniel\_Wladis](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/daniel_wladis/32/174984_2.png) [@Daniel\_Wladis](https://community.homey.app/u/Daniel_Wladis)\
**Post date:** [September 27, 2026, 8:43pm UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/99 "2026-09-27T20:43:39Z")

</div>

I’m running Homey Self-Hosted Server with the macOS app on a MacBook (Apple Silicon, macOS 26).

The Mac is connected to my LAN by cable through a USB Ethernet adapter (ASIX AX88179A), and that is its primary interface. With only Ethernet connected, Homey shows as offline in the mobile app and on my.homey.app. As soon as I turn on Wi-Fi and restart the app, Homey comes online.

It looks like the app’s virtual machine always bridges to en0. On a MacBook, en0 is the Wi-Fi interface, so the Ethernet adapter is never used. Wi-Fi coverage where the server sits is poor, so I need Homey to run over the wired connection.

My questions:

1. Is there a setting, config file or command to choose which network interface the VM bridges to, for example en5 or the USB Ethernet adapter?
2. If not, is this planned for a future version?

Other details:

- Homey has Local Network permission, and the macOS firewall is off.
- The Homey menu bar icon doesn’t appear, even though it’s allowed under Menu Bar settings.

---

<div class="post-metadata">

**Author:** ![MedievalRoadie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/medievalroadie/32/121008_2.png) [@MedievalRoadie](https://community.homey.app/u/MedievalRoadie)\
**Post date:** [September 29, 2026, 11:55am UTC](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435/100 "2026-09-29T11:55:25Z")

</div>

I think I’ve just run into this issue - migrated over to SHS on macOS and everything works fine _apart from_ Python Homey apps, immediately crashing with the below:

```auto

Error: uv_pipe_chmod EINVAL
    at Server.listen (node:net:2608:15)
    at AppLocal.createUnixDomainSocket (file:///app/packages/homey-local/lib/AppLocal.mts:1395:22)
    at async file:///app/packages/homey-local/lib/AppLocal.mts:1129:32
    at async AppLocal.executeStart (file:///app/packages/homey-local/lib/AppLocal.mts:1304:7)
    at async AppLocal.start (file:///app/packages/homey-local/lib/AppLocal.mts:988:7)

```

[Previous page](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435.md?page=4)

[Next page](https://community.homey.app/t/homey-self-hosted-server-on-macos-megathread/146435.md?page=6)
