Mailu

Description

Mailu is a simple yet full-featured mail server as a set of Docker images.

The project aims to provide people with an easily configurable, easily maintainable, and full-featured mail server without proprietary software or unnecessary features often found in popular groupware.

Roundcube is used as a webmail client.

Getting Started

Mailu is installed with an image and automatically starts when the server boots up.

After the image installation, the Mailu web interface will be accessible at https://example.com/, where example.com is your server’s hostname.

To access the administrative web interface, use the password that you can find in a file on the server:

/root/.app_password

To access this file, you will need to log in to the server via SSH. You can connect to the server via SSH:

• With an SSH key, if this option is enabled before a server is created
• With the root user password sent by mail when server is activated

Adding a Mail Domain

To add a new mail domain, go to Mail domains and click on New domain:

When adding a domain, specify:

1. Domain name (the Mailu web interface will also be accessible via this domain name)
2. Mailbox limit (number of users)
3. Maximum disk quota for users
4. Allow user self-registration

Click Save to finish.

Issuing an SSL Certificate

To obtain a free SSL certificate from Let's Encrypt for your web interface and email, you'll need to SSH into your server as the root user and run the following command:

mailu_domain add

You will be prompted to enter a domain or subdomain in the format subdomain.example.com and restart the services.

note

Make sure that your domain exists and points to the IPv4 address of your server!

Once the command completes, the web interface will be accessible at https://example.com/, where example.com is the domain (or subdomain) you specified.

DNS

You can see an example of DNS records for a domain by clicking on Details next to the mail domain.

To generate DKIM and DMARC keys, click on Regenerate keys.

note

The resource records are provided as an example. You will need to transfer them to your domain zone.

Creating User Mailboxes

You can add a user mailbox by clicking the User button next to the mail domain and then Add User in the top right corner of the page.

When creating a user mailbox, specify:

1. Name
2. Password
3. Disk quotas
4. Mail access protocol

Click Save to finish.

Configuring External Email Clients

Example configurations for email clients can be found in the Client setup menu. Autoconfiguration is available for Apple devices.

Configuring a Mail Fetcher

The mail fetcher for fetching mail from external servers is configured in the Fetched accounts menu.

When adding a new fetcher, specify:

1. Mail access protocol
2. Mail server domain
3. Login/password for the email account from which mail will be fetched
4. Whether to leave a copy of emails on the remote server
5. List of directories from which mail will be fetched

Installed Software

Name	License
Mailu	MIT License
Roundcube	GPLv3
Docker	GPLv3 (Apache 2.0)

Useful Links

For more information about the installed packages, please refer to their official documentation:

• Mailu
• Roundcube