aykroyd

README

Aykroyd — Email forwards via Postfix

Aykroyd is an HTTP server and web application that allows the user to manage email forwards in Postfix.

Installation

Pre-built binaries are available on the release page. Simply download, make executable, and move it to a folder in your PATH:

curl -L https://github.com/tja/aykroyd/releases/download/latest/aykroyd-`uname -s`-`uname -m` >/tmp/aykroyd
chmod +x /tmp/aykroyd
sudo mv /tmp/aykroyd /usr/local/bin/aykroyd

Dependencies

Install MariaDB or MySQL, create a schema postfix, and grant a user access to it:

CREATE SCHEMA `postfix`;
GRANT SELECT ON `postfix`.* TO `postfix`@`localhost` IDENTIFIED BY '<password>';

Install Postfix with MySQL support. Here is an example for Debian/Ubuntu:

sudo apt -y install postfix postfix-mysql

Add the Postfix domain config file /etc/postfix/mysql_virtual_alias_domains.cf:

user = postfix
password = <password>
hosts = 127.0.0.1
dbname = postfix
table = domains
select_field = name
where_field = name

Add the Postfix forwards config file /etc/postfix/mysql_virtual_alias_forwards.cf:

user = postfix
password = <password>
hosts = 127.0.0.1
dbname = postfix
table = forwards
select_field = to
where_field = from

Append the references to the two aforementioned files to /etc/postfix/main.cf:

virtual_alias_domains = mysql:/etc/postfix/mysql_virtual_alias_domains.cf
virtual_alias_maps = mysql:/etc/postfix/mysql_virtual_alias_forwards.cf

Usage

Run aykroyd in the command line, then visit http://localhost:2105/ to bring up the user interface.

License

Copyright (c) 2018 Thomas Jansen. Released under the MIT License.

Email icon made by Pixel Buddha from www.flaticon.com is licensed by CC 3.0 BY.