L’ancien tutoriel CasaOS pour Coolify reste utile comme point de départ vers le projet, mais il ne constitue pas une procédure d’installation prête à l’emploi pour les versions actuelles de ZimaOS. La différence essentielle est que Coolify nécessite un accès par clé SSH au serveur qu’il gère, tandis que ZimaOS protège certaines parties de son système de base en les rendant accessibles en lecture seule.
Dans le suivi du fil de discussion du forum publié en 2026, le blocage était précisément le suivant : Coolify demandait que sa clé publique soit copiée dans ~/.ssh/authorized_keys, mais l’utilisateur ne trouvait pas de chemin SSH root classique et accessible en écriture. Considérez cela comme un problème d’intégration à la plateforme, et non comme la preuve que Coolify est défectueux.
Pourquoi le guide CasaOS ne s’applique pas directement à ZimaOS
La documentation actuelle de Coolify indique qu’un serveur auto-hébergé doit disposer d’un accès SSH et que la clé publique utilisée par Coolify doit être autorisée pour le compte qu’il gère. Son programme d’installation crée également des données sous /data/coolify et s’attend à pouvoir gérer Docker sur l’hôte. Ces hypothèses sont normales sur un serveur Linux traditionnel.
ZimaOS est toutefois un système d’exploitation NAS de type appliance. Le guide SSH officiel de ZimaOS explique comment activer SSH depuis le mode développeur, mais ne garantit pas que tous les chemins Linux classiques soient accessibles en écriture ou persistants après les mises à jour du système.
Ce dont Coolify a besoin aujourd’hui
Le guide d’installation actuel de Coolify indique qu’il faut un serveur Linux 64 bits avec accès SSH et prise en charge de Docker, au moins 2 cœurs de processeur, 2 Go de RAM et 30 Go d’espace de stockage libre. Il recommande également un serveur vierge afin de limiter les conflits avec les services existants.
Coolify utilise SSH même lorsqu’il gère la même machine que celle sur laquelle il s’exécute. Sa documentation de configuration d’OpenSSH exige spécifiquement une authentification par clé. C’est pourquoi l’importation d’une simple définition d’application CasaOS ne supprime pas le besoin d’un accès SSH côté hôte.
Méthodes de déploiement plus sûres sur un serveur domestique ZimaOS
Si vous souhaitez utiliser Coolify principalement pour déployer des applications, la conception la plus propre consiste à l’exécuter dans un environnement Linux correspondant aux hypothèses prises en charge par Coolify, par exemple sur un serveur ou une machine virtuelle Debian/Ubuntu dédié(e), et à laisser ZimaOS gérer le stockage NAS ainsi que les autres services. Les modifications effectuées au niveau de l’hôte par Coolify restent ainsi éloignées du système de base protégé de ZimaOS.
Si vous souhaitez malgré tout expérimenter directement sur ZimaOS, commencez par sauvegarder les données des applications et vérifiez précisément où les clés SSH et l’état de Coolify seront conservés. Un dépôt communautaire documente le travail spécifique à ZimaOS en cours, mais il doit être considéré comme une expérimentation communautaire et non comme une méthode d’installation prise en charge par IceWhale : dépôt communautaire d’expérimentation de Coolify avec ZimaOS.
Pour les utilisateurs qui mettent en place un petit hôte de déploiement fonctionnant en permanence, un serveur domestique compact peut fournir la couche matérielle x86, tandis que le choix du système d’exploitation doit toujours dépendre des logiciels que vous prévoyez d’exécuter.
En résumé
Le fil de discussion du forum n’établit pas l’existence d’une méthode d’installation de Coolify sur ZimaOS en un clic. Il montre au contraire que la procédure CasaOS se heurte à une limite de persistance SSH sur ZimaOS. Prenez les exigences actuelles de Coolify comme référence principale et isolez Coolify dans un environnement Linux traditionnel si vous recherchez la méthode de mise à niveau et de récupération la plus prévisible.
