CasaOS y ZimaOS son sistemas operativos diferentes, por lo que pasar de uno a otro es una migración y no una actualización local. Se pueden transferir archivos, datos estándar de las aplicaciones y muchas configuraciones de Docker Compose, pero es posible que los usuarios del sistema, la configuración de red, los montajes de almacenamiento, los recursos compartidos y los contenedores con una personalización profunda deban recrearse manualmente.
La respuesta también cambió después de que se publicara inicialmente la pregunta de la comunidad. En julio de 2025, la respuesta oficial describía cómo copiar archivos a través de una LAN y reinstalar manualmente las aplicaciones. En septiembre de 2025, IceWhale publicó una guía de migración. La guía actual, actualizada en septiembre de 2026, añade la herramienta CTOZ para transferir muchos contenedores de la tienda de aplicaciones de CasaOS y sus datos.
Pasar de CasaOS a ZimaOS es una migración, no una actualización local
Una actualización local reemplazaría CasaOS y conservaría automáticamente su configuración del sistema. Ese no es el modelo descrito por el equipo de ZimaOS. Instalar ZimaOS crea un entorno de sistema operativo diferente, por lo que el plan seguro es hacer un inventario, crear una copia de seguridad, instalar, migrar, verificar y solo después retirar el entorno original.
No sobrescribas la única copia de tu sistema CasaOS hasta que los archivos personales, los datos de las aplicaciones, las definiciones de Compose, las credenciales y las notas de configuración se hayan copiado en un almacenamiento verificado.
Registra las rutas y la configuración de las aplicaciones antes de comenzar
La primera respuesta oficial recomendaba abrir el panel de configuración de cada aplicación y registrar sus rutas de carpetas existentes. Esto sigue siendo útil incluso cuando hay una herramienta de migración automatizada disponible, porque un contenedor puede iniciarse correctamente mientras apunta al directorio de datos equivocado.
Para cada aplicación, registra:
- Imagen y versión del contenedor.
- Rutas de volúmenes del host y del contenedor.
- Puertos y modo de red.
- Variables de entorno e identificadores de usuario/grupo.
- Carpetas de datos de aplicaciones, bases de datos, archivos multimedia y configuración.
- Cualquier red o dispositivo de Docker creado manualmente.
Migración cuando CasaOS y ZimaOS pueden ejecutarse al mismo tiempo
La forma más sencilla es mantener disponibles en la misma LAN el origen de CasaOS y el destino de ZimaOS. Comparte las carpetas necesarias de CasaOS mediante SMB, monta ese recurso compartido en Archivos de ZimaOS y copia o migra los datos al almacenamiento de destino.
Para las aplicaciones instaladas a través de la tienda de aplicaciones de CasaOS, la actual guía de migración de CasaOS a ZimaOS recomienda la herramienta CTOZ, desarrollada por la comunidad. CTOZ puede transferir el directorio AppData de CasaOS y el archivo YAML de Docker Compose correspondiente, y después reinstalar las aplicaciones compatibles en ZimaOS.
Lo que migra CTOZ
- AppData asociados con aplicaciones compatibles de CasaOS.
- El archivo YAML de Docker Compose utilizado para recrear los contenedores.
- Datos y configuración estándar de las aplicaciones cubiertos por esas carpetas asignadas.
Lo que CTOZ no migra automáticamente
- Usuarios de CasaOS y configuración a nivel del sistema.
- Configuración de red, puntos de montaje de almacenamiento y configuración de recursos compartidos.
- Contenedores no estándar implementados fuera de la tienda de aplicaciones de CasaOS.
- Cambios personalizados del sistema anfitrión que no están representados en los archivos AppData o Compose.
Migración cuando solo tienes un servidor
El hilo de 2025 destacó la topología más complicada: CasaOS y ZimaOS no pueden ejecutarse simultáneamente en el mismo servidor durante una reinstalación en el hardware. El equipo sugirió copiar primero los archivos a un PC con Windows y devolverlos después de instalar ZimaOS, gestionando cada aplicación y sus datos individualmente.
La guía actual también describe la exportación e importación de CTOZ para situaciones sin conexión o independientes. Esto puede reducir la reconstrucción manual de contenedores, pero no elimina la necesidad de almacenar las copias de seguridad de forma independiente. Antes de reemplazar CasaOS, exporta los materiales compatibles de las aplicaciones y cópialos, junto con los archivos personales y un registro independiente de la configuración del sistema, en un PC con Windows, un disco externo, un NAS u otro destino verificado.
Orden recomendado para migrar de CasaOS a ZimaOS
- Hacer un inventario: Enumera los archivos, recursos compartidos, aplicaciones, volúmenes, puertos, credenciales, bases de datos, usuarios y contenedores personalizados.
- Hacer una copia de seguridad: Crea al menos una copia verificada fuera del disco del sistema de CasaOS. Las bases de datos pueden requerir exportaciones específicas de la aplicación, además de copiar los archivos.
- Exportar aplicaciones compatibles: Usa el flujo de trabajo actual de CTOZ cuando corresponda y conserva el archivo YAML de Docker Compose.
- Instalar ZimaOS: Realiza la instalación limpia solo después de poder abrir la copia de seguridad desde otro dispositivo.
- Restaurar archivos: Copia los archivos personales y los datos de las aplicaciones en las ubicaciones de almacenamiento previstas de ZimaOS.
- Importar o reinstalar aplicaciones: Usa CTOZ o la importación manual de Compose de ZimaOS; después, corrige los puertos y las rutas de los volúmenes según sea necesario.
- Recrear la configuración del sistema: Configura los usuarios, los recursos compartidos, la red, los puntos de montaje y los permisos en ZimaOS.
- Validar: Abre cada aplicación, confirma sus datos, prueba las escrituras y los permisos, y comprueba el acceso remoto antes de eliminar la copia de seguridad.
Si una aplicación no se reinstala automáticamente
La documentación actual de ZimaOS indica que CTOZ transfiere AppData incluso cuando falla la instalación automatizada del contenedor. Si una carpeta de destino ya tiene el mismo nombre, la herramienta puede añadir un número en lugar de sobrescribirla. Después, el YAML de Compose exportado puede importarse manualmente a través de la tienda de aplicaciones de ZimaOS.
Después de cualquier migración automatizada, revisa la configuración de la aplicación y verifica que las rutas de los volúmenes apunten a las carpetas transferidas. Que un contenedor esté en ejecución no demuestra que su base de datos, biblioteca multimedia o configuración se hayan restaurado correctamente.
Gestiona manualmente los contenedores de CLI y no estándar
Los contenedores creados fuera de la tienda de aplicaciones de CasaOS quedan fuera del alcance automático documentado de CTOZ. Localiza sus montajes enlazados, volúmenes con nombre, AppData, archivos de Compose, variables de entorno y secretos. Después de instalar ZimaOS, vuelve a implementar la imagen o el proyecto de Compose y adjunta los datos restaurados utilizando las rutas de host correctas de ZimaOS.
El proyecto de código abierto CTOZ en GitHub proporciona el código fuente de la herramienta y la información de instalación actual a la que hace referencia la guía oficial.
Preguntas frecuentes sobre la migración de CasaOS a ZimaOS
¿Se puede actualizar CasaOS directamente a ZimaOS?
No. El equipo de ZimaOS los describió como sistemas operativos diferentes. Planifica una migración con copias de seguridad y una instalación limpia de ZimaOS en lugar de una actualización en el mismo sistema.
¿Se pueden trasladar las aplicaciones de CasaOS y sus datos a ZimaOS?
Muchos contenedores estándar de la tienda de aplicaciones de CasaOS pueden migrarse con CTOZ, incluidos sus datos de AppData y el YAML de Docker Compose. Los contenedores no compatibles o personalizados requieren una copia de seguridad y una redistribución manuales.
¿Necesito dos servidores?
Tener dos sistemas funcionando simultáneamente facilita la transferencia por LAN y la migración en línea con CTOZ, pero la documentación actual también describe la exportación/importación para migraciones sin conexión o independientes. Una migración con un solo servidor aún requiere otro lugar seguro donde guardar la copia de seguridad mientras se reemplaza CasaOS.
¿Puede un PC con Windows actuar como destino temporal de la migración?
Sí. La respuesta oficial de la comunidad sugirió copiar los archivos a Windows antes de instalar ZimaOS y volver a copiarlos después. Conserva los datos de las aplicaciones, las definiciones de Compose y los registros de configuración, además de los archivos personales.
¿Se transferirán automáticamente los usuarios, montajes y ajustes de red de CasaOS?
No. Las indicaciones actuales señalan que los usuarios del sistema, la configuración de red, los montajes de almacenamiento y los recursos compartidos deben recrearse o comprobarse manualmente en ZimaOS.
¿Qué versión de CasaOS requiere CTOZ?
La guía oficial actual especifica CasaOS 0.4.4 o posterior porque CTOZ depende de las configuraciones estandarizadas de Docker Compose utilizadas por las versiones más recientes de CasaOS.
