1. Ensure that GPG is installed and configured. Also make sure public keys for all of your potential recipients are available in the GPG home directory used for `keyhome` in step 2. 2. Configure `/etc/gpg-mailgate.conf` based on the provided `gpg-mailgate.conf.sample` 3. Install some python dependencies `apt-get install python-m2crypto python-markdown python-requests python-mysqldb` (for linux distributions based on Debian. If you have a non Debian based distribution, the install command might be different) 4. Place `gpg-mailgate.py` and `register-handler.py` in `/usr/local/bin/` 5. Place the GnuPG directory in `/usr/local/lib/python2.7/dist-packages` (replace 2.7 with your Python version) 6. Add the following to the end of `/etc/postfix/master.cf` gpg-mailgate unix - n n - - pipe flags= user=nobody argv=/usr/local/bin/gpg-mailgate.py ${recipient} 127.0.0.1:10028 inet n - n - 10 smtpd -o content_filter= -o receive_override_options=no_unknown_recipient_checks,no_header_body_checks -o smtpd_helo_restrictions= -o smtpd_client_restrictions= -o smtpd_sender_restrictions= -o smtpd_recipient_restrictions=permit_mynetworks,reject -o mynetworks=127.0.0.0/8 -o smtpd_authorized_xforward_hosts=127.0.0.0/8 7. Add the following to `/etc/postfix/main.cf` content_filter = gpg-mailgate 8. Add `register: |/usr/local/bin/register-handler.py` to `/etc/aliases` 9. Update postfix's alias database with `postalias /etc/aliases` 10. Restart postfix. 11. Create a dedicated user to store the public keys with these example commands: usermod -d /var/gpg nobody mkdir -p /var/gpg/.gnupg mkdir -p /var/smime/certs mkdir -p /var/gpgmailgate/register_templates chown -R nobody /var/gpg chown -R nobody /var/smime chown -R nobody /var/gpgmailgate chmod 700 /var/gpg/.gnupg sudo -u nobody /usr/bin/gpg --homedir=/var/gpg/.gnupg --import /some/public.key - Replace `/some/public.key` with the location of a public key - `/some/public.key` can be deleted after importation - Confirm that it's working: `sudo -u nobody /usr/bin/gpg --list-keys --homedir=/var/gpg/.gnupg` 12. Create directories for storing email templates: mkdir -p /var/gpgmailgate/register_templates mkdir -p /var/gpgmailgate/cron_templates chown -R nobody /var/gpgmailgate - Place the corresponding directories from this project in the created ones - Edit them if you want to 13. [Install gpg-mailgate-web] (gpg-mailgate-web/README)