1Panel-Appstore/maddy-mail

User Guide

1. Prepare Domain Certificates

Prepare a domain certificate using tools like acme.sh, certbot, or manual upload. Modify the configurations as needed.

The certificate domain should correspond to the mail server's MX hostname, such as mail.example.com.

2. Install the Application

Install the application from the app store.

The first installation may show an error and the container may not run properly due to missing certificate files.

Ignore the error and proceed to the next step.

3. Place the Domain Certificate into the Volume

If the maddydata directory is not present in the container storage volume, you need to manually execute:

docker volume create maddydata 

The default path for the volume is:/var/lib/docker/volumes/maddydata/_data/

# Enter the volume path
cd $(docker volume inspect maddydata --format '{{.Mountpoint}}')

# Create certificate folder
mkdir -p tls

Upload the certificate and private key to the tls folder, and rename them as:

• fullchain.pem
• privkey.pem

Once the certificates are correctly uploaded, the container will automatically start running.

4. Configure DKIM DNS Records

4.1 Retrieve DKIM Values

After the container starts running, check the path:/var/lib/docker/volumes/maddydata/_data/dkim_keys

You will find a file named like example.com_default.dns.

This file contains the required DKIM information.

• Make sure to modify the domain as needed.

To view the contents in the terminal:

cat /var/lib/docker/volumes/maddydata/_data/dkim_keys/example.com_default.dns 

Example output:

default._domainkey.example.org.    TXT   "v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg="

4.2 Set DNS TXT Record

Set the DNS records based on the retrieved information.

For example: Add a TXT record for default._domainkey.example.com with the value v=DKIM1; k=ed25519; p=nAcUUozPlhc4VPhp7hZl+owES7j7OlEv0laaDEDBAqg=.

5. Set DNS Records

• Ensure modifications as needed.

Record Type	Domain	Value
A	mail.example.com	Server IPv4 Address
A	example.com	Server IPv4 Address
AAAA	mail.example.com	Server IPv4 Address (if available)
AAAA	example.com	Server IPv4 Address (if available)
MX	example.com	mail.example.com
TXT	mail.example.com	v=spf1 mx ~all
TXT	example.com	v=spf1 mx ~all
TXT	_dmarc.example.com	v=DMARC1; p=quarantine; ruf=mailto:postmaster@example.com
TXT	_mta-sts.example.com	v=STSv1; id=1
TXT	_smtp._tls.example.com	v=TLSRPTv1;rua=mailto:postmaster@example.com

6. Create Sending Accounts

Access the container terminal via the Containers panel and execute the following commands:

• Ensure modifications as needed.

maddy creds create postmaster@example.com

maddy imap-acct create postmaster@example.com 

END