Soluzione della community

Installa Coolify su ZimaOS: ciò che manca nella guida di CasaOS

A January 2025 CasaOS tutorial later became a ZimaOS troubleshooting discussion when a user hit Coolify SSH-key requirements on the read-only system.

Il vecchio tutorial di CasaOS per Coolify è ancora utile come riferimento al progetto, ma non è una procedura di installazione immediata per l'attuale ZimaOS. La differenza fondamentale è che Coolify richiede l'accesso tramite chiavi SSH al server che gestisce, mentre ZimaOS protegge alcune parti del sistema di base rendendole di sola lettura.

Nel seguito del 2026 alla discussione sul forum, il problema era esattamente questo: Coolify chiedeva di copiare la propria chiave pubblica in ~/.ssh/authorized_keys, ma l'utente non riusciva a trovare un normale percorso SSH root scrivibile. Consideralo un problema di integrazione con la piattaforma, non una prova che Coolify sia danneggiato.

Perché la guida di CasaOS non si applica direttamente a ZimaOS

La documentazione attuale di Coolify indica che un server self-hosted deve consentire l'accesso SSH e che la chiave pubblica usata da Coolify deve essere autorizzata per l'account che gestisce. Il programma di installazione crea inoltre dati in /data/coolify e si aspetta di gestire Docker sull'host. Queste ipotesi sono normali su un server Linux convenzionale.

ZimaOS, tuttavia, è un sistema operativo NAS in stile appliance. La guida SSH ufficiale di ZimaOS mostra come abilitare SSH dalla Modalità sviluppatore, ma non garantisce che ogni percorso Linux convenzionale sia scrivibile o persistente dopo gli aggiornamenti del sistema.

Cosa richiede oggi Coolify

L'attuale guida all'installazione di Coolify indica un server Linux a 64 bit con accesso SSH e supporto Docker, almeno 2 core della CPU, 2 GB di RAM e 30 GB di spazio di archiviazione libero. Raccomanda inoltre un server nuovo per ridurre i conflitti con i servizi esistenti.

Coolify usa SSH anche quando gestisce la stessa macchina su cui è in esecuzione. La sua documentazione sulla configurazione di OpenSSH richiede specificamente l'autenticazione basata su chiavi. Per questo, importare semplicemente una definizione di app di CasaOS non elimina il requisito SSH sul lato host.

Percorsi di distribuzione più sicuri su un server domestico ZimaOS

Se vuoi usare Coolify principalmente per distribuire applicazioni, la soluzione più pulita è eseguirlo in un ambiente Linux che rispetti le ipotesi supportate da Coolify, ad esempio un server o una macchina virtuale Debian/Ubuntu dedicata, lasciando a ZimaOS la gestione dello spazio di archiviazione NAS e degli altri servizi. In questo modo le modifiche a livello host di Coolify restano lontane dal sistema di base protetto di ZimaOS.

Se vuoi comunque sperimentare direttamente su ZimaOS, esegui prima un backup dei dati delle applicazioni e verifica esattamente dove verranno mantenuti le chiavi SSH e lo stato di Coolify. Un repository della community documenta il lavoro specifico per ZimaOS ancora in corso, ma dovrebbe essere considerato una sperimentazione della community, non un percorso di installazione supportato da IceWhale: repository di apprendimento della community per Coolify su ZimaOS.

Per gli utenti che stanno creando un piccolo host di distribuzione sempre attivo, un server domestico compatto può fornire il livello hardware x86, mentre la scelta del sistema operativo dovrebbe comunque dipendere dal software che intendi eseguire.

In sintesi

La discussione sul forum non dimostra l'esistenza di un metodo con un solo clic per installare Coolify su ZimaOS. Dimostra il contrario: la procedura di CasaOS raggiunge un limite relativo alla persistenza SSH su ZimaOS. Usa i requisiti attuali di Coolify come riferimento principale e isola Coolify in un ambiente Linux convenzionale quando vuoi ottenere il percorso di aggiornamento e ripristino più prevedibile.