Communityoplossing

Geplande taken uitvoeren op ZimaOS met Zima Cron

An official January 2026 IceWhale tutorial for installing Zima Cron through zpkg and creating interval or cron-expression tasks. Later replies reported inconsistent persistence after reboot, including an open issue where zima-cron.service becomes inactive.

Zima Cron is een van de weinige planningstools die rechtstreeks voor ZimaOS is gepubliceerd in plaats van als generieke Docker-container te zijn toegevoegd. De tutorial van IceWhale uit januari 2026 laat zien hoe je de tool installeert met zpkg, taken op basis van intervallen of cron-expressies maken, de uitvoering via logboeken controleren en de tool gebruiken voor scripts, back-ups of routinematig onderhoud.

De brondiscussie bevat ook een belangrijk tweede verhaal dat de korte versie van dit artikel eerder te veel had samengevat: persistentie na een herstart was niet consistent tussen systemen. Sommige gebruikers van ZimaOS 1.5.3 en 1.5.4 raakten al hun geplande taken kwijt of merkten dat ze zima-cron.service inactief waren na een herstart, terwijl een schone testomgeving liet zien dat taken een herstart overleefden. De juiste conclusie is daarom “officiële planner met een persistentievoorbehoud dat afhankelijk is van de versie”, en niet simpelweg “installeer hem en kijk er niet meer naar om.”

Installeer Zima Cron met de officiële zpkg-pakketbeheerder

De tutorial van IceWhale begint in de ZimaOS-terminal en gebruikt:

zpkg install zima_cron

De bron vermeldt expliciet dat na de installatie geen herstart nodig is. Zima Cron zou vervolgens in de lijst met apps in de webinterface van ZimaOS moeten verschijnen.

Het ZimaOS-dashboard toont Zima Cron in de lijst met geïnstalleerde applicaties nadat zpkg install zima_cron is uitgevoerd
In de tutorial van IceWhale verschijnt Zima Cron direct na de installatie als applicatie via zpkg.

Maak een veilige testtaak voordat je iets belangrijks plant

De officiële tutorial gebruikt bewust een ongevaarlijke logtaak van één minuut in plaats van een destructieve onderhoudsopdracht. Dat is een goede aanpak voor elke planner: controleer eerst of de backend wordt uitgevoerd, of de planning correct wordt geïnterpreteerd en of de uitvoer op de verwachte locatie wordt opgeslagen, voordat je back-ups of het opnieuw starten van services automatiseert.

Het scherm Taak maken van Zima Cron met velden voor taaknaam, opdracht, plantype en interval
De taakeditor ondersteunt een opdracht plus een intervalplanning of een standaard cron-expressie.

In het officiële voorbeeld wordt een tijdstempel aan een logbestand toegevoegd:

bash -c 'echo "$(date "+%Y-%m-%d %H:%M:%S") zima cron works" >> /DATA/zima_cron_test.log'

Omdat deze opdracht alleen tekst toevoegt, is deze geschikt om de planning te controleren zonder de applicatiestatus te wijzigen.

Gebruik intervalplanning voor eenvoudige herhaling

Een intervalplanning is geschikt wanneer het exacte tijdstip niet van belang is. Voorbeelden zijn een lichte gezondheidscontrole om de paar minuten of een opschoontaak om de paar uur.

Houd er bij belangrijke taken rekening mee dat “elke 24 uur” niet altijd hetzelfde is als “elke dag om 04.00 uur”, vooral na het opnieuw opstarten van services. Gebruik een cron-expressie wanneer een specifiek tijdstip van de dag belangrijk is.

Gebruik standaard cron-expressies voor planningen op basis van de kalender

De officiële tutorial demonstreert ook de standaardsyntaxis van cron. Bijvoorbeeld:

*/5 * * * *

wordt elke vijf minuten uitgevoerd. Een normale cron-expressie kan dagelijkse, wekelijkse, maandelijkse of weekspecifieke planningen weergeven, waardoor Zima Cron flexibeler is dan alleen een vast interval.

Voordat je een ingewikkelde expressie implementeert, test je die met een onschadelijke logopdracht en verifieer je ten minste twee succesvolle uitvoeringen.

Verifieer de uitvoering in Zima Cron en in het uitvoerbestand

De takenlijst van Zima Cron met een geplande testtaak en succesvolle herhaalde uitvoeringslogboeken
De officiële tutorial verifieert de planner aan de hand van de taakstatus en herhaalde uitvoeringslogboeken, in plaats van ervan uit te gaan dat een opgeslagen taak daadwerkelijk wordt uitgevoerd.

Een volledige test moet zowel de gebruikersinterface van de planner als het verwachte neveneffect controleren, bijvoorbeeld nieuwe regels in /DATA/zima_cron_test.log. Hiermee vang je situaties op waarin een taak in de gebruikersinterface bestaat, maar de opdracht mislukt door machtigingen, paden, aanhalingstekens of ontbrekende binaire bestanden.

Voor het plannen van het opnieuw opstarten van apps is de juiste opdrachtgrens vereist

Een gebruiker vroeg hoe Home Assistant dagelijks om 04.00 uur opnieuw kon worden opgestart. De thread kreeg geen officiële IceWhale-opdracht voor het beheren van een specifieke geïnstalleerde app, dus dit artikel moet er geen verzinnen. Zima Cron kan shellopdrachten uitvoeren, maar de exacte opdracht voor een applicatie hangt af van de manier waarop die app door ZimaOS wordt beheerd en van de vraag of het veilig is om de app buiten de applicatiebeheerlaag om opnieuw op te starten.

Gebruik de planner voor opdrachten die je al handmatig hebt geverifieerd. Maak van het opnieuw opstarten van een productieapplicatie niet de eerste test.

De belangrijkste kanttekening: sommige gebruikers verloren taken na het opnieuw opstarten

Op 26 januari meldde een ZimaOS 1.5.3-gebruiker dat opgeslagen taken na het opnieuw opstarten verdwenen. 777-Spider antwoordde dat IceWhale de kwestie zou onderzoeken. Vervolgens reproduceerden andere gebruikers vergelijkbaar gedrag, waardoor het een reëel betrouwbaarheidsprobleem werd in plaats van een eenmalig misverstand.

Later bleek een gecontroleerde schone installatie naar verluidt correct te werken: zima-cron.service bleef actief, taken bleven zichtbaar na het opnieuw opstarten en het loggen ging door. Dat zag er veelbelovend uit, maar daarmee was het verhaal nog niet afgelopen.

Schone tests en tests in de praktijk leverden verschillende resultaten op

Een latere deelnemer installeerde Zima Cron via zpkg, een taak aangemaakt en vervolgens na een herstart gemeld dat de taken verdwenen waren en dat er geen nieuwe taken konden worden aangemaakt. De servicestatus was:

zima-cron.service
Geladen: geladen
Actief: inactief (gestopt)

Dat sprak het resultaat op een schoon systeem rechtstreeks tegen, waarbij de service automatisch startte en taken behouden bleven. De juiste interpretatie is dat de problemen met het behouden van taken afhankelijk waren van de omgeving of build en niet definitief voor elke gebruiker zijn opgelost.

Wat je na een herstart moet controleren

In de thread werd aanbevolen te controleren of de service nog steeds actief is en of de installatie correct is uitgevoerd via zpkg. Voor een kritieke implementatie moet de minimale QA na een herstart het volgende omvatten:

  1. Start de ZimaOS-machine bewust opnieuw op.
  2. Controleer of Zima Cron nog steeds wordt weergegeven.
  3. Bevestig dat de opgeslagen taak zichtbaar blijft.
  4. Bevestig dat de backendservice actief is.
  5. Wacht op de volgende geplande uitvoering.
  6. Controleer de daadwerkelijke uitvoer van de taak, niet alleen de status in de gebruikersinterface.

Het probleem met het behouden van taken werd ook openbaar gemeld

Het Zima Cron-project heeft een openbare issue waarin wordt beschreven dat taken verloren gaan en de service na een herstart inactief blijft. Voordat je erop vertrouwt voor onbemand onderhoud, controleer je de actuele status van het rapport over het behouden van taken na een herstart.

Maak van een niet-geteste planner niet je enige back-uptrigger

Zima Cron is nuttig voor automatisering, maar een geplande back-up die na een herstart stilletjes verdwijnt, is erger dan een handmatige back-up waarvan je weet dat die niet is uitgevoerd. Als de taak belangrijk is, combineer dan het testen van de planner met onafhankelijke controles van de back-upstatus en verificatie van terugzetten.

Veelgestelde vragen over Zima Cron

Is de installatieopdracht voor Zima Cron officieel?

Ja. zpkg install zima_cron werd gepubliceerd door 777-Spider in de IceWhale-tutorial.

Kan het normale cron-expressies gebruiken?

Ja. De officiële tutorial ondersteunt zowel intervalschema's als standaard cron-expressies.

Blijven taken zeker behouden na een herstart?

Op basis van de oorspronkelijke thread kan er geen universele garantie worden gegeven. Sommige tests op schone systemen slaagden, terwijl andere systemen met versie 1.5.x herhaaldelijk taken kwijtraakten of de service inactief achterlieten.

Wat moet ik doen voordat ik erop vertrouw voor een kritieke taak?

Voer een echte herstarttest uit, controleer of de taak nog steeds is ingesteld en bevestig dat de opdracht daarna succesvol wordt uitgevoerd.