Skip to main content
Version: 2026.2

Cron Jobs

CMF needs the following cron jobs. Depending on your project's requirements, the execution interval can differ, and some of these jobs might not be needed at all.

Segment Building Queue​

Handles the calculation of asynchronous segments by processing the segment building queue. This is needed for segments that could not be calculated directly for performance reasons.

* * * * * php /home/project/www/bin/console cmf:build-segments -v > /home/project/www/log/cmf-build-segments-queue-lastrun.log

Action Trigger Queue​

Handles the execution of delayed actions in ActionTrigger rules.

* * * * * php /home/project/www/bin/console cmf:process-actiontrigger-queue -v > /home/customerdataframework/www/website/var/log/cmf-process-actiontrigger-queue-lastrun.log

Cron Trigger​

Needed if cron triggers are used in ActionTrigger rules. This job must run once per minute.

* * * * * php /home/project/www/bin/console cmf:handle-cron-triggers -v > /home/project/www/log/cmf-cron-trigger-lastrun.log

Calculate Potential Duplicates​

Analyzes the duplicates index and calculates the potential duplicates shown in the potential duplicates list view.

0 0 * * * php /home/project/www/bin/console cmf:duplicates-index -c -v > /home/project/www/log/cmf-potential-duplicates-lastrun.log

CMF Maintenance​

Run this job on a regular basis. It calls the maintenance methods the bundle wires up by default in its own services.yml:

  • executeSegmentBuilderMaintenance on SegmentBuilderExecutorInterface
  • processQueue on the segment assignment IndexerInterface (see Segment Assignment)
  • cleanUpFilterDefinitions on the customer view filter definition maintenance service
  • cleanUpTemporaryCustomers on the customer view maintenance service
* * * * * php /home/project/www/bin/console cmf:maintenance -v > /home/project/www/log/cmf-cron-maintenance-lastrun.log

Newsletter Queue​

Processes the newsletter queue. Run this every few minutes (for example every 5 minutes) when the newsletter/Mailchimp sync feature is enabled.

*/5 * * * * php /home/project/www/bin/console cmf:newsletter-sync -c > /home/project/www/log/cmf-newsletter-sync-lastrun.log

Mailchimp Status Sync​

Run this as a nightly job. It synchronizes status updates from Mailchimp to Pimcore for cases where webhook calls failed, which matters for data integrity when the system was down for several hours.

Configure a dedicated Pimcore username (for example mailchimp-cli) in the CMF config; this user shows up in the version history (see Configuration). The CLI user needs no special permissions, it only identifies the updates in the version history.

0 0 * * * php /home/project/www/bin/console cmf:newsletter-sync -m > /home/project/www/log/cmf-mailchimp-status-sync-lastrun.log