Solución de la comunidad

Instalar Coolify en ZimaOS: lo que omite la guía de 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.

El antiguo tutorial de Coolify para CasaOS sigue siendo útil como referencia del proyecto, pero no es una receta de instalación directa para el ZimaOS actual. La diferencia clave es que Coolify espera tener acceso mediante claves SSH al servidor que administra, mientras que ZimaOS protege partes de su sistema base como de solo lectura.

En la continuación de 2026 del hilo del foro, el bloqueo era exactamente este: Coolify solicitaba copiar su clave pública en ~/.ssh/authorized_keys, pero el usuario no podía encontrar una ruta SSH raíz normal con permisos de escritura. Considéralo un problema de integración con la plataforma, no una prueba de que Coolify esté averiado.

Por qué la guía de CasaOS no se aplica directamente a ZimaOS

La documentación actual de Coolify indica que un servidor autohospedado necesita acceso SSH y que la clave pública utilizada por Coolify debe autorizarse para la cuenta que administra. Su instalador también crea datos en /data/coolify y espera administrar Docker en el equipo anfitrión. Estas suposiciones son normales en un servidor Linux convencional.

Sin embargo, ZimaOS es un sistema operativo NAS de estilo dispositivo. La guía oficial de SSH de ZimaOS muestra cómo habilitar SSH desde el modo de desarrollador, pero no garantiza que todas las rutas habituales de Linux tengan permisos de escritura o persistan tras las actualizaciones del sistema.

Qué necesita Coolify actualmente

La guía de instalación de Coolify actual indica que se necesita un servidor Linux de 64 bits con acceso SSH y compatibilidad con Docker, al menos 2 núcleos de CPU, 2 GB de RAM y 30 GB de almacenamiento libre. También recomienda un servidor nuevo para reducir los conflictos con servicios existentes.

Coolify utiliza SSH incluso cuando administra el mismo equipo en el que se ejecuta. Su documento de configuración de OpenSSH espera específicamente autenticación basada en claves. Por eso, importar simplemente una definición de aplicación de CasaOS no elimina el requisito de SSH en el equipo anfitrión.

Opciones de implementación más seguras en un servidor doméstico ZimaOS

Si quieres usar Coolify principalmente para implementar aplicaciones, el diseño más limpio es ejecutarlo en un entorno Linux que coincida con las suposiciones compatibles con Coolify, como un servidor o una máquina virtual dedicada con Debian/Ubuntu, y dejar que ZimaOS continúe gestionando el almacenamiento NAS y otros servicios. Así, los cambios a nivel del anfitrión que realiza Coolify se mantienen alejados del sistema base protegido de ZimaOS.

Si aun así quieres experimentar directamente en ZimaOS, haz primero una copia de seguridad de los datos de las aplicaciones y confirma exactamente dónde persistirán las claves SSH y el estado de Coolify. Un repositorio comunitario de aprendizaje documenta el trabajo específico para ZimaOS, pero debe considerarse experimentación de la comunidad, no una vía de instalación respaldada por IceWhale: repositorio comunitario de aprendizaje sobre Coolify en ZimaOS.

Para quienes están creando un pequeño equipo de implementación siempre activo, un servidor doméstico compacto puede proporcionar la capa de hardware x86, mientras que la elección del sistema operativo debe seguir dependiendo del software que quieras ejecutar.

En resumen

El hilo del foro no demuestra que exista un método de un solo clic para instalar Coolify en ZimaOS. Demuestra lo contrario: la receta de CasaOS alcanza un límite de persistencia de SSH en ZimaOS. Usa los requisitos actuales de Coolify como referencia principal y aísla Coolify en un entorno Linux convencional si quieres disfrutar de una ruta de actualización y recuperación lo más predecible posible.