A quick start to download and install MailerQ
Lets run MailerQ
Installing on Debian/Ubuntu based systems
wget http://packages.copernica.com/copernica.key
sudo apt-key add copernica.key
rm copernica.key
echo "deb http://packages.copernica.com/debian stable main" | sudo tee /etc/apt/sources.list.d/copernica.list
sudo apt-get update
sudo apt-get install mailerq
Installing on Red Hat based systems
To install MailerQ on a new version of CentOS, Red Hat or Fedora, enter the following instructions in your shell:
sudo wget http://packages.copernica.com/rpm/copernica.repo -O /etc/yum.repos.d/copernica.repo
sudo yum update
sudo yum install mailerq
Specific versions
We have more information provided if you want to download specific versions.
License file
To run MailerQ, you need a valid license file. This file contains the list of IP addresses from which you are going to send out mail, and the features that should be enabled.
It is best to store your license file as "etc/mailerq/license.txt". If you store it in a different location, you have to update your config file.
Setting up RabbitMQ
MailerQ depends on RabbitMQ for message queueing. This means that before you can even start MailerQ, you first need a running RabbitMQ instance. We do not intend to write a full installation guide for RabbitMQ here, because the www.rabbitmq.com website has all the information you need, although other webpages are a bit more user friendly.
Installing RabbitMQ on Debian / Ubuntu
Here is a short example how to install RabbitMQ on Debian / Ubuntu. To install, execute the following commands.
echo 'deb http://www.rabbitmq.com/debian/ testing main' | sudo tee /etc/apt/sources.list.d/rabbitmq.list
wget -O- https://www.rabbitmq.com/rabbitmq-release-signing-key.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install rabbitmq-server
Installing on RPM-based Linux (RHEL, CentOS, Fedora, openSUSE)
First you need to install Erlang, the RabbitMQ runtime.
wget https://packages.erlang-solutions.com/erlang-solutions-1.0-1.noarch.rpm
sudo rpm -Uvh erlang-solutions-1.0-1.noarch.rpm
sudo yum install erlang erlang-nox
After that you can install RabbitMQ server. Use the following commands to install the latest version of RabbitMQ.
wget https://www.rabbitmq.com/releases/rabbitmq-server/v3.6.10-1/rabbitmq-server-3.6.10-1.noarch.rpm
sudo rpm --import https://www.rabbitmq.com/rabbitmq-release-signing-key.asc
sudo yum install rabbitmq-server-3.6.10-1.noarch.rpm
We do not intend to write a full installation guide for RabbitMQ here. However, we do have some tips, tricks and recommendations for setting up RabbitMQ with MailerQ.
Start MailerQ and connect RabbitMQ
MailerQ is configured via one central configuration file: "/etc/mailerq/config.txt". The most important ones are the address and login credentials of your RabbitMQ message broker, MailerQ Management Console and the address of your database.
To start RabbitMQ as an administrator, start the server for Debian using:
sudo service rabbitmq-server start
MailerQ listens on ports 25 and 80 to show the Management Console. Make sure to stop any apache, postfix or other process that's blocking those ports, although you can change the default easely in the config file.
# Management console configuration
www-port: 8485
www-password: mailerq
Within this configfile you configure MailerQ to change the Management Console password for example. Although all other config file settings have decent defaults you might want to take a look at them.
After you connected MailerQ to RabbitMQ you can start MailerQ
sudo service mailerq start
Thats all!
Hello World example
Go to your localhost or localhost:8485 to access the MailerQ Management Console and send your first email with MailerQ!
The simplest example to send a message using MailerQ is via the cli:
echo -e "from: your_email@domain.com\nto: your_email@domain.com\nsubject: MailerQ example message\n\nHello World" | mailerq --extract-recipients --ignore-dot
If you are fast enough, you can track this message in the management console.
Cheers,
The MailerQ team