Mautic Cron Jobs – Complete Setup Guide

???? Purpose

Mautic relies on cron jobs to:

• Sync contacts into segments
• Move contacts into campaigns
• Execute campaign actions (like sending emails)
• Send queued emails

Without cron jobs, campaigns will NOT run automatically.

Server Details (Your Setup)

• Domain Path:
  /home/yourwebsite.com/public_html (Confirm your Path)
• PHP Binary:
  /usr/local/lsws/lsphp83/bin/php

Required Cron Jobs

1️⃣ Segments Update

Purpose:
Updates segments and adds/removes contacts based on filters.

Command:

/usr/local/lsws/lsphp83/bin/php /home/yourwebsite.com/public_html/bin/console mautic:segments:update

Schedule:

*/5 * * * *

2️⃣ Campaigns Update

Purpose:
Moves contacts from segments into campaigns.

Command:

/usr/local/lsws/lsphp83/bin/php /home/yourwebsite.com/public_html/bin/console mautic:campaigns:update

Schedule:

*/5 * * * *

3️⃣ Campaigns Trigger ⚡ (Most Important)

Purpose:
Executes campaign actions (e.g., sending welcome emails).

Command:

/usr/local/lsws/lsphp83/bin/php /home/yourwebsite.com/public_html/bin/console mautic:campaigns:trigger

Schedule:

* * * * *

4️⃣ Messages Send ????

Purpose:
Processes and sends queued emails.

Command:

/usr/local/lsws/lsphp83/bin/php /home/yourwebsite.com/public_html/bin/console mautic:messages:send

Schedule:

* * * * *

???? How Mautic Workflow Works

1. segments:update
   ↓
2. campaigns:update
   ↓
3. campaigns:trigger
   ↓
4. messages:send

???? This pipeline ensures:

• Contact enters segment
• Contact enters campaign
• Campaign executes
• Email is delivered

???? Manual Testing Commands

Run these manually for debugging:

php bin/console mautic:segments:update
php bin/console mautic:campaigns:update
php bin/console mautic:campaigns:trigger
php bin/console mautic:messages:send

⚠️ Common Issues & Fixes

❌ Emails not sending

• Check messages:send cron
• Verify SMTP settings

❌ Campaign not triggering

• Check campaigns:trigger cron
• Ensure delay = 0

❌ Contacts not entering campaign

• Run campaigns:update
• Verify segment filters

❌ Nothing works

• Check correct PHP path
• Check correct Mautic path
• Ensure cron is actually running

???? Best Practice

For near real-time automation:

• campaigns:trigger → every 1 minute
• messages:send → every 1 minute
• Others → every 5 minutes