{: .no_toc }

{: .no_toc .text-delta }

1. TOC {:toc}

Currently only Ubuntu 20.04 with systemd is officially supported.

Add the repository:

$ curl -s https://apt.mailway.app/ubuntu/KEY.gpg | sudo apt-key add -
$ sudo curl -s -o /etc/apt/sources.list.d/mailway.list https://apt.mailway.app/ubuntu/mailway.list
$ sudo apt update

$ sudo apt install mailway

This will install Mailway and all its components.

Mailway can operate in two modes:

Connected mode is simpler to setup and allows to configure the routing rules using the Mailway dashboard:

$ mailway setup

Once the setup is completed, the service will automatically start.

Local mode is a standalone email service and doesn't require communicating with Mailway online services:

$ mailway setup --local

See how to Configure local routing rules.

docker run \
    -p 25:25 -p 80:80 -p 443:443 \
    -v /etc/mailway:/etc/mailway \
    -v /var/log/mailway:/var/log/journal \
    mailway/mailway

docker run \
    -p 25:25 \
    -v /etc/mailway:/etc/mailway \
    -v /var/log/mailway:/var/log/journal \
    -e MW_HOSTNAME=example.com \
    -e MW_EMAIL=youremail@example.com \
    mailway/mailway-local

Environment variables:

• MW_HOSTNAME: email server hostname (example: mx.example.com).
• MW_EMAIL: email used for TLS certificates.