Open Infrastructure

h1. The ungleich mail infrastructure

{{toc}}

h2. Status

This document is *IN PROGRESS*.

h2. Mail overview

* "Webmail":https://webmail.ungleich.ch/

* Outgoing mail server: smtp.ungleich.ch, port 25, starttls

* Incoming mail server: mail.ungleich.ch, imaps

Mail settings:

smtp: smtp.ungleich.ch port 587 STARTTLS

imap: mail.ungleich.ch port 143 STARTTLS

h2. The primary mx configuration

* Is found in the cdist type __ungleich_mx_primary (in our ungleich internally used dot-cdist)

h2. How to add a new user

* Have the user run doveadm to create a hash (@doveadm pw -s sha512-crypt@)

* Have the user submit the hash to an admin

* Modify type/__ungleich_mx_primary/files/dovecot/vpasswd to include the mail account

** Username should be firstname.lastname@ungleich.ch for staff

** Commit & push

* Run cdist config mx.place5.ungleich.ch

h2. How to add a new domains

* Edit type/__ungleich_mx_primary/files/postfix/vdomain

** Add the new domain

* Commit & push

* Run cdist config mx.place5.ungleich.ch

h2. How to add a new mail alias

* Edit type/__ungleich_mx_primary/files/postfix/valiases

** Add alias mail (First one is the alias => Will send incoming mail to the following email addresses)

* Commit & push

* Run cdist config mx.place5.ungleich.ch

h2. How to update the mail server

Since all the configuration is located in cdist a simple @cdist config mx.place5.ungleich.ch@ does the trick.

h2. Sieve filters

Can be configured via:

* "Webmail":https://webmail.ungleich.ch/ - go to Settings - Filters

or

* Thunderbird "sieve plugin":https://addons.thunderbird.net/thunderbird/addon/sieve/

h2. The backup mx configuration

<to be filled in by Jin-Guk>