A set of ansible scripts, to set up fully functional, self-hosted mailserver
Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
roles Added blackhole alias for postfix for all unwanted emails Aug 5, 2016
LICENSE Initial commit Apr 27, 2015
README.md Various minor fixes. Added vagrant support for development and testing May 22, 2016
Vagrantfile Various minor fixes. Added vagrant support for development and testing May 22, 2016
ansible-vagrant Various minor fixes. Added vagrant support for development and testing May 22, 2016
main.yml

README.md

self-hosted-mailserver

A set of ansible scripts, to set up fully functional, self-hosted mailserver.

This set of scripts was based on those excellent articles:

with some exceptions:

  • no EncFS - because it's pointless
  • no full text search - beacuse it's JAVA
  • added Roundcube - because you might need your email the less you expect it
  • added ddclient - since mobile hardware needs mobile support
  • and as a bonus - there is also a ownCloud installation scripts available

Those rules were written with Debian in mind, and were tested in Jessie (8.0). They should also work on Ubuntu, but I didn't try it and you shouldn't too. Also, by default E-mail and Web servers disables SSLv2, SSLv3, TLSv1 and TLSv1.1. This can cause problems with apps like Apple Mail or MSIE, but if you are concerned in privacy, this shouldn't be a big issue - since you should not use them anyway...

Install

Suggestions below would do, but if you like, I also wrote a a blog post with more detailed approach.

First of all you need ansible

brew/apt-get/yum/whatever install ansible

Also, you need an inventory file, and configure all the hosts you wish to install your mailserver to:

cat << EOF > ansible-inventory
[local]
123.234.345.456 ansible_ssh_user=root
some.other.host.com ansible_ssh_user=root
EOF

See ansible documentation for more details. If you wish to use ansible_ssh_user=root like in example above, don't forget to put your public key to /root/.ssh/authorized_keys on the remotes.

Next, you need to configure your new system(s) variables:

for role in base duplicity maildb postfix nginx owncloud roundcube security; do vi roles/${role}/vars/main.yml; done

and add your SSL certificates to roles/ssl/templates/certs-this-machine.pem and roles/ssl/templates/private-this-machine.pem. I strongly recommed to use trusted certificate (for example from here), but you can also create a self-signed one. Last thing you need to configure is roles/ddclient/templates/ddclient.conf.j2 for ddclient (or disable it in main.yml if you won't need it).

Also keep in mind, that those scripts would create many 4096bit primes, and would take a while (especially security and SSL roles). If you wish to sped them up (not recommended), set security.strong_primes flag in roles/security/vars/main.yml to false. Another option, is disabling it and generating those primes on stronger machine (this is very relevant, if you plan to use those scripts on ARM machine like Raspberry PI). To see which commands are invoked, type:

cat roles/*/tasks/main.yml | grep -B1 'when: security.strong_primes' | grep shell

Adapt them as necessary, and then copy generated files to proper locations on remote machine (after ansible script finished its magic).

And you're ready to rock!

ansible-playbook -s -i ansible-inventory main.yml

Have fun, and don't forget to set your TXT and PTR records for DKIM and SPF!

Testing and development

For the convenience there is a preconfigured Vagrant configuration, for those who wish to run those scripts on sandbox environment. All you have to do is:

vagrant up
ansible-playbook -s -i ansible-vagrant main.yml

All services will be exposed on 10xxx ports (so email will be on 10025, www on 10080 and 10443 etc.).