Mautic 5 Amazon SES configuration<\/figcaption><\/figure>\n\n\n\nMautic will send the emails via SES using immediate delivery as it’s the default way of sending messages. If you plan on sending a higher volume of emails, it’s better to use the queuing mechanisms that are designed to handle those workloads.
Our personal favorite is using Redis as queueing mechanism. This feature was long awaited in Mautic and starting with version 5 that relies on Symfony 5 framework, we can finally use wide variety of queues, including Redis and even Amazon SQS. <\/p>\n\n\n\n
Redis configuration<\/h2>\n\n\n\n
If you haven’t already, you can read an in-depth article about how to configure Mautic and Redis.<\/p>\n\n\n\n
Now, we will assume you already have a Redis server, either as a service on your server or as a separate instance. The configuration is easy. Once again, we are going to use DSN to configure the Email and SMS queue. <\/p>\n\n\n\n
Install the symfony\/redis-messenger<\/em> package.<\/p>\n\n\n\ncomposer require symfony\/redis-messenger<\/code><\/pre><\/div>\n\n\n\nThen, in Mautic configuration, go to the Queue Settings and look for the first form, Queue for email (SMS and push messages)<\/strong>.<\/p>\n\n\n\nHere you have to define at least three settings in case you are using the default Redis installation:<\/p>\n\n\n\n
\n- Scheme: redis<\/li>\n\n\n\n
- Host: 127.0.0.1 (or the IP address of your Redis instance)<\/li>\n\n\n\n
- Port: 6379<\/li>\n<\/ul>\n\n\n\n
Hit save and close and you are good to go. <\/p>\n\n\n\n
UPDATE<\/strong><\/p>\n\n\n\nFrom now on, Mautic is utilizing the workers from Symfony, meaning that you don’t have to set up a cron job to send emails. In fact, you might end up overloading the server since every minute you will spawn a new service for picking up emails from the queue and processing them. So instead of creating new cron, ignore this and set up a daemon on your server. <\/p>\n\n\n\n
Lastly, you need to update your cronjobs to enable sending emails. <\/s><\/p>\n\n\n\n* * * * * php \/path\/to\/mautic\/bin\/console messenger:consume email<\/code><\/pre><\/div>\n\n\n\nUsing Supervisor to Send emails with Mautic 5 and Amazon SES<\/h2>\n\n\n\n
For running our workers in the background, we will utilize the supervisor<\/strong>. It’s a program that allows us to spawn processes in the background and ensure that they are running if they are terminated. This allows us to have an always running worker that will check for new emails in the queue and send them. <\/p>\n\n\n\nHere we will cover installing and configuring supervisor on Ubuntu 22.04.<\/p>\n\n\n\n
First, connect to your server via SSH and run following command:<\/p>\n\n\n\n
sudo apt update && sudo apt install supervisor<\/code><\/pre><\/div>\n\n\n\nAfter the installation is completed, the service should run automatically. You can verify that by running the command: <\/p>\n\n\n\n
sudo systemctl status supervisor<\/code><\/pre><\/div>\n\n\n\nCheck for the following output:<\/p>\n\n\n\n
systemctl status supervisor\n\u25cf supervisor.service - Supervisor process control system for UNIX\n Loaded: loaded (\/lib\/systemd\/system\/supervisor.service; enabled; vendor preset: enabled)\n Active: active (running) since Sat 2024-01-13 20:24:30 UTC; 39min ago\n Docs: http:\/\/supervisord.org\n Main PID: 807 (supervisord)\n Tasks: 14 (limit: 4556)\n Memory: 718.9M<\/code><\/pre><\/div>\n\n\n\nAfter the installation, we can move and configure our daemon.<\/p>\n\n\n\n
We are spawning the new workers by creating the config file in the supervisor. <\/p>\n\n\n\n
sudo nano \/etc\/supervisor\/conf.d\/mautic-mail.conf<\/code><\/pre><\/div>\n\n\n\nNext, paste and adjust the following code to match your Mautic installation:<\/p>\n\n\n\n
[program:mautic-mail]\ndirectory=\/var\/www\/path\/to\/mautic\/instance\ncommand=php bin\/console messenger:consume email\nprocess_name=%(program_name)s_%(process_num)02d\nautostart=true\nautorestart=true\nuser=www-data\nredirect_stderr=true\nnumprocs=1\nstdout_logfile=\/var\/log\/mautic\/mautic-mail-daemon.log<\/code><\/pre><\/div>\n\n\n\nLet’s explain this in key details:<\/p>\n\n\n\n
[program:mautic-mail]\n<\/code><\/pre><\/div>\n\n\n\n\n- program: mautic-mail<\/strong> is simply the unique name of your daemon. You can set it to anything you’d like<\/li>\n\n\n\n
- directory<\/strong> tells us where your Mautic installation is located<\/li>\n\n\n\n
- command <\/strong>– this is the actual command. If you have multiple PHP versions installed on your server, you can use the alias for the version you are using (php8.1, php8.0, or leave php if it’s the correct version)<\/li>\n\n\n\n
- autostart<\/strong> and autorestart <\/strong>directives allow us to restart the process in case it’s stopped.<\/li>\n\n\n\n
- user<\/strong> is the actual user under which your mautic instance is running. By default, it’s www-data<\/li>\n<\/ol>\n\n\n\n
After updating the config file with your settings, save the file and exit the editor. Next, we will instruct the supervisor to check for new config files.<\/p>\n\n\n\n
sudo supervisorctl reread<\/code><\/pre><\/div>\n\n\n\nIf everything is okay, you should see the following output:<\/p>\n\n\n\n
Output\nmautic-mail: available<\/code><\/pre><\/div>\n\n\n\nAfter seeing the correct output, we can update the supervisor to run our worker.<\/p>\n\n\n\n
sudo supervisorctl update<\/code><\/pre><\/div>\n\n\n\nAnd once again, if everything is okay, we will see the following output;<\/p>\n\n\n\n
Output\nmautic-mail: added process group<\/code><\/pre><\/div>\n\n\n\nTo verify that the worker is running, we can enter the supervisor by running supervisorctl<\/strong> in your terminal.<\/p>\n\n\n\nsudo supervisorctl<\/code><\/pre><\/div>\n\n\n\nRight after the launch, supervisor will list the running processes:<\/p>\n\n\n\n
Output\nmautic-mail RUNNING pid 23274, uptime 0:03:12\nsupervisor><\/code><\/pre><\/div>\n\n\n\nTo exit supervior, type quit<\/strong> and we are back to our terminal.<\/p>\n\n\n\nAnd that’s it. If you have followed everything, your Mautic will be configured and sending emails with Amazon SES. <\/p>\n\n\n\n
Combined with Redis, you will have a truly scalable solution that will handle sending thousands of emails without any problems. <\/p>\n\n\n\n
![\"Mautic](\"https:\/\/otb.agency\/wp-content\/uploads\/2024\/01\/Screenshot-2024-01-10-at-21.49.35-1024x291.png\")