Setting Up Email ServerΒΆ

To work with code in the signup process it’s often best to setup email communication for the site. It does not do this automatically and you need an smtp server for it to send email out to test accounts.

One way to setup an smtp server is to use a small tool, msmtp.

This assumes that you’re on Ubuntu. You’ll need to adjust these instructions for your own platform. If you get it working please feel free to submit a pull request with your platform as we’ll happily add it to the docs.

$ sudo apt-get install msmtp
$ touch ~/.msmtprc
$ chmod 0600 ~/.msmtprc

Next, edit the ~/.msmtprc file with your favourite text editor. The configuration file should contain the following lines.

defaults
account examplemail
host smtp.examplemail.com
tls on
tls_certcheck off
port 587
auth login
from somebody@example.com
user somebody@example.com
password somesecret

account default: examplemail

In the above example, the host has to be replaced with your email service smtp host. The from, user, and password, needs to be valid for your own email account.

Once that’s complete, you can perform simple test to ensure your configuration is correct. Copy and paste these lines to your command prompt modifying the email address to your own address:

cat <<EOF | msmtp someone@example.com
Subject: test

This is a test!
EOF

If all the instructions are followed correctly, you can now receive the activation mail to the specified email address.

Previous topic

Makefile

Next topic

Bookie Tests

This Page