Zima Cron es una de las pocas herramientas de programación publicadas directamente para ZimaOS en lugar de añadirse como un contenedor Docker genérico. El tutorial de IceWhale de enero de 2026 muestra cómo instalarlo con zpkg, crea tareas basadas en intervalos o expresiones cron, verifica la ejecución mediante registros y úsalo para scripts, copias de seguridad o mantenimiento rutinario.
El hilo de origen también contiene una segunda historia importante que la versión breve de este artículo había resumido demasiado: la persistencia después de reiniciar era incoherente entre sistemas. Algunos usuarios de ZimaOS 1.5.3 y 1.5.4 perdieron todas las tareas programadas o descubrieron zima-cron.service inactivo después de reiniciar, mientras que un entorno de prueba limpio mostró que las tareas sobrevivían al reinicio. La conclusión correcta es, por tanto, «programador oficial con una salvedad de persistencia dependiente de la versión», no simplemente «instálalo y olvídate de él».
Instala Zima Cron con el gestor oficial de paquetes zpkg
El tutorial de IceWhale comienza desde el terminal de ZimaOS y utiliza:
zpkg install zima_cron
La fuente indica explícitamente que no es necesario reiniciar después de la instalación. Zima Cron debería aparecer entonces en la lista de aplicaciones de la interfaz web de ZimaOS.
zpkg.Crea una tarea de prueba segura antes de programar algo importante
El tutorial oficial utiliza deliberadamente una tarea de registro inofensiva de un minuto en lugar de un comando de mantenimiento destructivo. Es un buen patrón para cualquier programador: comprueba que el backend se ejecuta, que la programación se interpreta correctamente y que la salida se escribe donde se espera antes de automatizar copias de seguridad o reinicios de servicios.
El ejemplo oficial añade una marca de tiempo a un archivo de registro:
bash -c 'echo "$(date "+%Y-%m-%d %H:%M:%S") zima cron works" >> /DATA/zima_cron_test.log'
Como este comando solo añade texto, es adecuado para verificar la programación sin modificar el estado de la aplicación.
Usa la programación por intervalos para repeticiones sencillas
Un horario de intervalos es apropiado cuando no importa la hora exacta del reloj. Algunos ejemplos son una comprobación ligera del estado cada pocos minutos o una tarea de limpieza cada varias horas.
Para las tareas importantes, recuerda que “cada 24 horas” no siempre equivale a “todos los días a las 4:00”, especialmente después de reiniciar los servicios. Usa una expresión cron cuando sea importante una hora concreta.
Usa expresiones cron estándar para programaciones basadas en el calendario
El tutorial oficial también muestra la sintaxis cron estándar. Por ejemplo:
*/5 * * * *
se ejecuta cada cinco minutos. Una expresión cron normal puede representar programaciones diarias, semanales, mensuales o específicas para determinados días de la semana, lo que hace que Zima Cron sea más flexible que un simple intervalo fijo.
Antes de implementar una expresión complicada, pruébala con un comando de registro inofensivo y verifica al menos dos ejecuciones correctas.
Verifica la ejecución en Zima Cron y en el archivo de salida
Una prueba completa debería comprobar tanto la interfaz del programador como el efecto secundario esperado, por ejemplo, nuevas líneas en /DATA/zima_cron_test.log. Esto detecta los casos en los que existe una tarea en la interfaz, pero su comando falla por permisos, rutas, comillas o archivos binarios faltantes.
Programar reinicios de aplicaciones requiere delimitar correctamente el comando
Un usuario preguntó cómo reiniciar Home Assistant todos los días a las 4:00. El hilo no recibió ningún comando oficial de IceWhale para gestionar una aplicación instalada específica, así que este artículo no debería inventar uno. Zima Cron puede ejecutar comandos de shell, pero el comando exacto para una aplicación depende de cómo la gestione ZimaOS y de si es seguro reiniciarla fuera de la capa de gestión de aplicaciones.
Usa el programador para comandos que ya hayas verificado manualmente. No hagas que la primera prueba sea el reinicio de una aplicación en producción.
La principal salvedad: algunos usuarios perdieron sus tareas después de reiniciar
El 26 de enero, un usuario de ZimaOS 1.5.3 informó que las tareas guardadas desaparecían después de reiniciar. 777-Spider respondió que IceWhale investigaría el problema. Después, otros usuarios reprodujeron un comportamiento similar, lo que lo convirtió en un problema real de fiabilidad y no en un simple malentendido aislado.
Más tarde, según se informó, una instalación limpia y controlada funcionó correctamente: zima-cron.service siguió activo, las tareas permanecieron visibles después del reinicio y el registro continuó. Parecía prometedor, pero ese no era el final de la historia.
Las pruebas en limpio y las pruebas en condiciones reales produjeron resultados diferentes
Más adelante, otro participante instaló Zima Cron mediante zpkg, creó una tarea y después informó que, tras reiniciar, las tareas habían desaparecido y no se podían crear tareas nuevas. El estado de su servicio mostraba:
zima-cron.service
Cargado: cargado
Activo: inactivo (muerto)
Eso contradecía directamente el resultado en un sistema limpio, donde el servicio se iniciaba automáticamente y las tareas persistían. La interpretación correcta es que los problemas de persistencia dependían del entorno o de la compilación, y no estaban resueltos de forma concluyente para todos los usuarios.
Qué comprobar después de un reinicio
El hilo recomendaba comprobar si el servicio seguía activo y si la instalación se había realizado correctamente mediante zpkg. Para una implementación crítica, el control de calidad mínimo después del reinicio debería ser:
- Reinicia deliberadamente la máquina ZimaOS.
- Confirma que Zima Cron siga apareciendo.
- Confirma que la tarea guardada siga visible.
- Confirma que el servicio del backend esté activo.
- Espera a la siguiente ejecución programada.
- Verifica el resultado real de la tarea, no solo el estado mostrado en la interfaz.
El problema de persistencia también se informó públicamente
El proyecto Zima Cron tiene un problema público en el que se describen la pérdida de tareas y un servicio inactivo después de reiniciar. Antes de confiar en él para el mantenimiento desatendido, consulta el estado actual del informe sobre la persistencia tras el reinicio.
No conviertas un programador sin probar en tu único activador de copias de seguridad
Zima Cron es útil para la automatización, pero una copia de seguridad programada que desaparece silenciosamente después de un reinicio es peor que una copia manual que sabes que no se ha ejecutado. Si la tarea es importante, combina las pruebas del programador con comprobaciones independientes del estado de las copias de seguridad y verificaciones de restauración.
Preguntas frecuentes sobre Zima Cron
¿Es oficial el comando de instalación de Zima Cron?
Sí. zpkg install zima_cron fue publicado por 777-Spider en el tutorial de IceWhale.
¿Puede usar expresiones cron normales?
Sí. El tutorial oficial admite tanto programaciones por intervalos como expresiones cron estándar.
¿Las tareas sobreviven definitivamente al reinicio?
No se puede ofrecer una garantía universal a partir del hilo original. Algunas pruebas en instalaciones limpias tuvieron éxito, mientras que otros sistemas 1.5.x perdieron tareas repetidamente o dejaron el servicio inactivo.
¿Qué debo hacer antes de confiarle una tarea crítica?
Realiza una prueba de reinicio completa, verifica que la tarea siga definida y confirma que el comando se ejecute correctamente después.
