add documentation on how to use a mailclient with this setup

README.md

@@ -10,8 +10,9 @@
 1. [About](#about)
 2. [Requirements](#requirements)
 3. [How to use](#how-to-use)
-4. [How to develop locally](#how-to-develop-locally)
-5. [How to test and troubleshoot the setup](docs/how-to-test-and-troubleshot-the-setup.md)
+4. [How to connect via a mail client (Thunderbird)](docs/thunderbird/how-to-connect-with-thunderbird.md)
+5. [How to develop locally](#how-to-develop-locally)
+6. [How to test and troubleshoot the setup](docs/how-to-test-and-troubleshot-the-setup.md)
 
 # About
 
@@ -35,7 +36,7 @@ A docker image that will provide an out of the box mailserver using
 - Your _mailserver domain_ **A record (or cname)** points to the machine where  this docker mailserver will run.
   - ![CNAME Mailserver Domain Record Namescheap Example](./docs/maildomain-cname-example.png)
 - Your webserver is configured to listen for your _mailserver domain_ port 80, so letsencrypt can generate and renew the ssl certificate
-- You need to expose the required ports through your security groups/firewall in order to connect to the mailserver.  
+- You need to expose the ports that you will use through your security group or firewall. Port 465 and 143 must be available, the rest are optional only if you use them
   - 25     # smtp
   - 465    # smtps
   - 110    # pop3

docs/thunderbird/how-to-connect-with-thunderbird.md

@@ -0,0 +1,21 @@
+# How to connect with Thunderbird
+
+This guide will show you how to connect to your newly created mailserver with Thunderbird.
+
+The logic and steps are the same across all clients, but as our favorite is Thunderbird we use that one in this example.
+
+1 Right-click on the left sidebar then choose `Settings`
+
+![open thunderbird settings](./1-open-settings.png)
+
+2 Add the new account, in our example `[email protected]`
+![add the new account](./2-add-new-account.png) 
+
+The most important thing here is using port `143`
+
+3 Finally add outgoing smtp server which will allow you to send emails
+
+![add outgoing smtp server](./3-add-smtp-server.png)
+
+
+That is all, now Thunderbird will ask for your password and afterward have fun receiving and sending emails!