MailerQ is a Mail Transfer Agent (MTA) that uses RabbitMQ for its message queues. Before you install and configure MailerQ you will need to download and set-up RabbitMQ. Once you have installed RabbitMQ and have access to a running and up-to-date RabbitMQ server, you can proceed with installing MailerQ. For tips on how to install RabbitMQ, read our RabbitMQ installation article.
Note: MailerQ requires RabbitMQ version 3.3.1+
After you have installed your RabbitMQ server, you can proceed with setting up MailerQ. Installing the MailerQ Mail Transfer Agent (MTA) on a Linux server is easy. We have downloads for Debian based (Debian, Ubuntu, etc) and Red Hat based environments (Red Hat, Fedora, CentOS, etc).
After you have downloaded the appropriate MailerQ .deb or .rpm file, you can install it on your system. This can probably be achieved by double-clicking on it if you have a desktop computer, or with one of the following command line instructions:
$ sudo rpm -i /path/to/mailerq-version.rpm
$ sudo dpkg -i path/to/mailerq-version.deb
Now MailerQ is installed on your system. The MTA can be started by entering the "mailerq" command on the command line. But before you do this, you probably want to make some changes to the configuration file.
MailerQ is configured via one central configuration file "config.txt" that can be found in the "/etc/mailerq" directory. It holds many options that you should set before you can start MailerQ. The most important options are the address and login credentials of your RabbitMQ message broker and your license key location. The configuration of these options is discussed below. A complete list of all options on how MailerQ interacts with RabbitMQ can be found here. A list of other configurable options is given [here](configuration "MailerQ configuration").
MailerQ reads the location and authentication information to connect with RabbitMQ from its config file. Make sure you include the following variables in the MailerQ configuration file (/etc/mailerq/config.txt):
rabbitmq-host: <Hostname(s) of your RabbitMQ server(s)> rabbitmq-user: <Your RabbitMQ username> rabbitmq-password: <Your RabbitMQ password> rabbitmq-vhost: <The RabbitMQ environment MailerQ may use>
rabbitmq-host variable holds the hostname of your RabbitMQ server. If you have
a cluster of RabbitMQ nodes they have to
be separated by a semi-colon (e.g. host1;host2;host3;). Setting up a cluster means you
will have highly available queues.
rabbitmq-password variables hold the username and
password of your RabbitMQ server, as set in your RabbitMQ configuration. The default
username is guest/guest, however this only works when connecting to localhost. If you
run RabbitMQ on a separate server, you will need to set your own username and password,
or configure the RabbitMQ server to allow guest/guest logins from remote hosts (see
[RabbitMQ's Access Control Configuration](https://www.rabbitmq.com/access-control.html
"RabbitMQ's Access Control Configuration")).
If you have created a specific RabbitMQ vhost environment you can add the specific vhost
rabbitmq-vhost variable. The default vhost is "/".
These basic settings enable MailerQ to connect to RabbitMQ. A complete list of all configurable options on how MailerQ interacts with RabbitMQ can be found here
After creating a MailerQ account, you can download a license from this website. MailerQ should be aware of the location of this license. This location can be set in the configuration file via:
license: <Path to your license>
On a clean installation the path to the license is set to the same directory as config.txt (i.e. /etc/mailerq/). If you have questions about your license, feel free to send an email to firstname.lastname@example.org.
With these configuration steps you are ready to start. However, we do recommend to read the page on how MailerQ interacts with RabbitMQ and checking all other configuration options, so you can adjust your configuration accordingly.
Now you're ready to get started. Enter "mailerq" on the command line and your MTA is running.
MailerQ comes with a web based management console that you can use to monitor exactly what is happening. This MTA console can be opened from your browser. The port number and password can be set in the config file (for more information see Management Console. The default location is http://your-server-name:8485.
To start sending mails with MailerQ, you need to publish an e-mail to the appropriate message queue in RabbitMQ or use one of our examples.
One of our favourite tools in MailerQ is tags. With tags, you can do a lot on an individual delivery level - or on any level ...
We are excited to announce the latest version of MailerQ - version 5.5 - which includes improved insights into deliveries that are sch...