app-MAIL-temp/docs/troubleshooting.md

Troubleshooting

A. If you can't receive a welcome email when signing up

This can either mean:

1. Postfix can't send emails to your mailbox
2. The sl-app container can't connect to Postfix (run on the host)

A.1

To test 1), running swaks --to your-mailbox@mail.com should send you an email. Make sure to replace your-mailbox@mail.com by your mailbox address. swaks can be installed with sudo apt install swaks on Debian-based OS.

A.2

Once 1) works, we can test the 2) by

a) first connecting to the container by docker exec -it sl-app bash b) then run the following commands

apt update
apt install telnet -y
telnet 10.0.0.1 25

If the telnet 10.0.0.1 25 doesn't work, it means Postfix can't be reached from the docker container. This means an issue with the Docker network.

You can then try telnet 172.17.0.1 25 as 172.17.0.1 is usually the host IP address. If this works, then you can set the POSTFIX_SERVER=172.17.0.1 in your SimpleLogin config file ~/simplelogin.env and re-run all the containers.

If not, please run through the self-hosting instructions and make sure no step is missed.

B. You send an email to your alias and can't receive the forwarded email on your mailbox

This can be either due to:

1. Postfix doesn't recognize the alias domain
2. Postfix can't connect to the sl-email container
3. sl-email container can't connect to Postfix
4. Postfix can't send emails to

B.1

For 1), this can mean the /etc/postfix/pgsql-relay-domains.cf and /etc/postfix/pgsql-transport-maps.cf aren't correctly set up. To test 1), postmap -q mydomain.com pgsql:/etc/postfix/pgsql-relay-domains.cf should return mydomain.com.

And postmap -q not-exist.com pgsql:/etc/postfix/pgsql-relay-domains.cf should return nothing.

postmap -q mydomain.com pgsql:/etc/postfix/pgsql-transport-maps.cf should return smtp:127.0.0.1:20381

And postmap -q not-exist.com pgsql:/etc/postfix/pgsql-transport-maps.cf should return nothing.

B.2

For 2), you can check in the sl-email log by running docker logs sl-email and if the incoming email doesn't appear there, then it means Postfix can't connect to the sl-email container. Please run through the self-hosting instructions and make sure no step is missed.

B.3

For 3), you can check in the sl-email log by running docker logs sl-email and make sure there's no error there.

B.4

For 4), please refer to the A.1 section to make sure Postfix can send emails to your mailbox.