The easiest way to install Mailur is to run bin/install script.
Replace example.com everywhere with name of your server.
Pre-requirements: a server or podman container with CentOS 8.
Default username and password: demo / demo
# prepare code
yum install -y git
git clone https://github.com/naspeh/mailur.git /opt/mailur
cd /opt/mailur
# run script
bin/install
Open http://example.com:5000 in the browser.
Change config in bin/env that looks like:
#!/bin/sh
# used for creation of virtual mailboxes
# use a space separator for multiple users
user=demo
# comment next line if you modify "/etc/dovecot/passwd.users"
pass={plain}demo
# used in "bin/deploy" for nginx and certbot
domain=example.com
# used as password for dovecot master users
# used as "doveadm_password"
secret=5969dd9f462f403b8a2866f6d79fa399
# used by cli/web application
export MLR_DOMAIN=$domain
export MLR_SECRET=$secret
export MLR_MASTER=root:$secret
export MLR_SIEVE=sieve:$secret
export MLR_IMAP_OFF=''
and run bin/install again, it's safe to run multiple times.
Ensure proper $domain is set in bin/env.
Run bin/deploy. It will deploy all stuff behind nginx with free SSL certificate from Let's Encrypt.
Open https://example.com in the browser.
IMAPS will be available on server too.
. bin/activate
# using Gmail (demo is our user)
mlr demo remote-setup-gmail {username} {password}
# or using general IMAP/SMTP server
mlr demo remote-setup-imap {username} {password} --imap=mail.example.com --smtp=mail.example.com
# initial import
mlr demo remote --parse
# and install systemd service to import new messages
user=demo bin/install-idle-sync
Note: I use two-factor authentication for Gmail with app password for Mailur.
I use two servers with master-master replication enabled.
For that for each user you should add userdb_mail_replica parameter with your second server in /etc/dovecot/passwd.users like:
demo:{plain}demo::::::userdb_mail_replica=tcps:replica.example.com