Communityoplossing

Installeer Homey Self-Hosted Server op ZimaOS: actuele Docker Compose, hostnetwerken en back-ups

A February 2026 thread where a user asked for an easy Homey Self-Hosted Server install. A community member pasted Homey's official Docker run command using host networking, privileged mode, restart policy, and a persistent ~/.homey-shs volume. The original poster confirmed it installed and worked. Homey's current official Linux/Compose guide still uses the same architecture.

De bronoplossing is opvallend actueel gebleven. Een communityreactie verwees rechtstreeks naar Homey's officiële Linux-instructies en gebruikte een Docker-container met hostnetwerk, bevoorrechte modus, automatisch opnieuw starten en een permanente ~/.homey-shs map. De oorspronkelijke poster antwoordde dat de installatie werkte.

Op Homey's huidige officiële supportpagina's wordt nog steeds dezelfde containerarchitectuur gebruikt en wordt nu ook een Docker Compose-voorbeeld aangeboden. Op ZimaOS is Compose meestal eenvoudiger te documenteren en te reproduceren dan een eenmalige docker run opdracht.

Controleer de huidige minimale vereisten van Homey

Voor Homey Self-Hosted Server is momenteel het volgende vereist:

  • Intel/AMD- of Arm-CPU met 64-bits ondersteuning;
  • minimaal 1 GB beschikbaar RAM;
  • minimaal 1 GB beschikbare opslag;
  • een speciaal LAN-IP-adres of pad dat clients kunnen bereiken.

ZimaOS biedt Docker al, dus voer Homey's algemene script voor het installeren van Docker niet uit op de host.

De bron gebruikte Homey's officiële Docker Run-architectuur

De gebruikte bronopdracht was:

  • --network host;
  • --privileged;
  • --restart unless-stopped;
  • een permanente hostmap gekoppeld aan /homey/user/;
  • ghcr.io/athombv/homey-shs.

De oorspronkelijke poster bevestigde dat de server was geïnstalleerd en werkte.

De huidige Homey-documentatie biedt ook Docker Compose

Het onderhouden Compose-voorbeeld van Homey gebruikt hetzelfde ontwerp:

services:
  homey-shs:
    image: ghcr.io/athombv/homey-shs:latest
    container_name: homey-shs
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - ~/.homey-shs:/homey/user

Zie Homey's huidige Self-Hosted Server Compose-workflow.

Gebruik een weloverwogen persistent pad op ZimaOS

De upstream ~/.homey-shs het pad is geldig in een algemene Linux-shell, maar op ZimaOS is het netter om een expliciete schrijfbare opslaglocatie te kiezen, zoals een speciale AppData-map onder de opslagruimte waarvan je daadwerkelijk back-ups maakt.

Koppel die hostmap aan /homey/user en documenteer ze vóór toekomstige herinstallaties.

Hostnetwerken is bewust gekozen

De officiële Compose-configuratie van Homey gebruikt network_mode: host, waardoor de container rechtstreeks toegang krijgt tot de netwerknaamruimte van de host in plaats van tot gewone Docker-poorttoewijzing.

Dit helpt bij LAN-detectie en communicatie met apparaten, maar vermindert ook de netwerkisolatie. Controleer welke services de container op de host opent.

De modus met uitgebreide rechten is een aanzienlijke toekenning van machtigingen

De officiële Homey-container draait met uitgebreide rechten. Daardoor heeft de container veel ruimere toegang tot de host en apparaten dan een normale App Store-service.

Gebruik alleen de officiële image/bron en houd deze bijgewerkt. Voeg geen niet-gerelateerde software toe aan dezelfde container met uitgebreide rechten.

Ken de servicepoorten van Homey

De huidige documentatie van Homey vermeldt standaard server-/bridgepoorten, waaronder 4859-4862. Door hostnetwerken verschijnen deze luisterende poorten rechtstreeks op de ZimaOS-host.

Als er een hostfirewall zoals ZFW wordt gebruikt, zorg er dan voor dat de vereiste LAN-poorten bewust worden toegestaan.

Voltooi de installatie in de mobiele Homey-app

Open Homey op iOS of Android nadat de container actief is, voeg een nieuwe Homey toe en selecteer Self-Hosted Server. Als automatische detectie mislukt, staat de huidige Homey-configuratie het volgende toe HOMEY_LOCAL_ADDRESS om het lokale LAN-IPv4-adres van de host te definiëren.

Werk bij door de container te pullen en opnieuw aan te maken

De huidige instructies van Homey werken de image bij en maken de container opnieuw aan, terwijl de persistente map op de host behouden blijft. De gegevens blijven behouden omdat ze buiten de wegwerpcontainer staan.

Maak een back-up van de persistente Homey-map

Homey zegt uitdrukkelijk dat je de bestanden en mappen in de gekozen .homey-shs pad. Die back-up is belangrijker dan het behouden van de container zelf.

Veelgestelde vragen over Homey op ZimaOS

Heeft de brongebruiker bevestigd dat Homey werkte?

Ja. Ze zeiden dat de voorgestelde Docker-installatie goed werkte.

Moeten ZimaOS-gebruikers Docker installeren met het curl-script van Homey?

Nee. ZimaOS bevat Docker al; gebruik alleen het gedeelte over de container en Compose.

Waarom /homey/user buiten de container persistent maken?

Die map bevat de permanente status van Homey en maakt het mogelijk de container bij te werken of opnieuw aan te maken zonder de configuratie te verliezen.