La soluzione di origine rimane insolitamente aggiornata. Un membro della community ha indicato direttamente le istruzioni ufficiali di Homey per Linux e ha utilizzato un container Docker con rete dell'host, modalità privilegiata, riavvio automatico e una cartella persistente ~/.homey-shs directory. L'autore del post originale ha risposto che l'installazione funzionava.
Le pagine di supporto ufficiali attuali di Homey utilizzano ancora la stessa architettura dei container e ora forniscono anche un esempio Docker Compose. Su ZimaOS, Compose è solitamente più semplice da documentare e riprodurre rispetto a un docker run comando.
Verifica i requisiti minimi attuali di Homey
Attualmente Homey Self-Hosted Server richiede:
- CPU Intel/AMD o Arm a 64 bit;
- almeno 1 GB di RAM disponibile;
- almeno 1 GB di spazio di archiviazione disponibile;
- un indirizzo IP LAN dedicato o un percorso raggiungibile dai client.
ZimaOS include già Docker, quindi non eseguire sul sistema host lo script generico di Homey per «installare Docker».
La soluzione originale utilizzava l'architettura Docker Run ufficiale di Homey
Il comando sorgente utilizzato era:
-
--network host; -
--privileged; -
--restart unless-stopped; - una cartella persistente dell'host mappata su
/homey/user/; -
ghcr.io/athombv/homey-shs.
L'autore del post originale ha confermato che il server è stato installato e funzionava.
La documentazione attuale di Homey fornisce anche Docker Compose
L'esempio Compose mantenuto da Homey utilizza lo stesso design:
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/userConsulta il flusso di lavoro attuale di Homey Self-Hosted Server con Compose.
Usa un percorso persistente definito su ZimaOS
L'upstream ~/.homey-shs Il percorso è valido in una shell Linux generica, ma su ZimaOS è più ordinato scegliere una posizione di archiviazione scrivibile esplicita, ad esempio una cartella AppData dedicata all'interno dello spazio di archiviazione di cui esegui effettivamente il backup.
Mappa quella cartella dell'host su /homey/user e documentalo prima delle reinstallazioni future.
La rete dell'host è intenzionale
Il Compose ufficiale di Homey usa network_mode: host, che concede al container accesso diretto allo spazio dei nomi di rete dell'host invece della normale mappatura delle porte Docker.
Questo facilita il rilevamento nella LAN e la comunicazione con i dispositivi, ma riduce anche l'isolamento della rete. Verifica quali servizi il container espone sull'host.
La modalità privilegiata concede permessi significativi
Il container ufficiale di Homey viene eseguito in modalità privilegiata. Ciò conferisce al container capacità di accesso all'host e ai dispositivi molto più ampie rispetto a un normale servizio dell'App Store.
Usa esclusivamente l'immagine/la fonte ufficiale e mantienila aggiornata. Non aggiungere software non correlato allo stesso container privilegiato.
Conosci le porte del servizio Homey
La documentazione attuale di Homey elenca le porte predefinite del server/bridge, incluse 4859-4862. La rete dell'host fa sì che questi listener siano esposti direttamente sull'host ZimaOS.
Se viene utilizzato un firewall dell'host, come ZFW, assicurati che le porte LAN richieste siano consentite in modo esplicito.
Completa la configurazione nell'app mobile Homey
Dopo l'avvio del container, apri Homey su iOS o Android, aggiungi un nuovo Homey e seleziona Self-Hosted Server. Se il rilevamento automatico non riesce, la configurazione attuale di Homey consente HOMEY_LOCAL_ADDRESS per definire l'indirizzo IPv4 della LAN dell'host.
Aggiorna eseguendo il pull e ricreando il container
Le istruzioni attuali di Homey aggiornano l'immagine e ricreano il container mantenendo la cartella persistente sull'host. I dati sopravvivono perché risiedono al di fuori del container temporaneo.
Esegui il backup della cartella persistente di Homey
Homey indica esplicitamente di eseguire il backup dei file e delle cartelle archiviati nel percorso scelto .homey-shs percorso. Quel backup è più importante che preservare il container stesso.
Domande frequenti su Homey in ZimaOS
L'utente della fonte ha confermato che Homey funzionava?
Sì. Hanno detto che l'installazione di Docker suggerita funzionava bene.
Gli utenti di ZimaOS devono installare Docker con lo script curl di Homey?
No. ZimaOS include già Docker; usa solo la parte relativa al container/Compose.
Perché rendere persistente /homey/user al di fuori del container?
Quella directory contiene lo stato persistente di Homey e consente di aggiornare o ricreare il container senza perdere la configurazione.
