jhammah/mail-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Josh
2025-06-19 13:15:57 +00:00
parent 8355400c4b
commit 4e8b6d83e2
1 changed files with 70 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
README.md
View File

@ -105,7 +105,7 @@
* **We're also making HAProxy's container depend on Stalwart's container** * **We're also making HAProxy's container depend on Stalwart's container**
* **And finally we are creating a custom "hap-network" for all of these containers. * **And finally we are creating a custom "hap-network" for all of these containers.**
* **If you need to make any changes of IP's or ports, you can do so in this file. If you're good with the assigned IP's and ports, then this file should be ready to rock n roll.** * **If you need to make any changes of IP's or ports, you can do so in this file. If you're good with the assigned IP's and ports, then this file should be ready to rock n roll.**
@ -123,9 +123,9 @@
## stalwart.yml file ## stalwart.yml file
* **This is the stalwart.yml file where we define all the differnt aspects of how we want this container to be built. * **This is the stalwart.yml file where we define all the differnt aspects of how we want this container to be built.**
* **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in the yml file that you can download. It will look a little different than what is in the video but it will work better.** ### **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in the yml file that you can download. It will look a little different than what is in the video but it will work better.**
* **The container will be named "stalwart"** * **The container will be named "stalwart"**
@ -196,7 +196,7 @@ docker-compose up -d
## Stalwart UI First Logon and Configuration ## Stalwart UI First Logon and Configuration
* **Once you've ran and built the HAProxy, Stalwart, and Roundcube containers, let's load up Stalwart's Admin UI.** * **Once you've ran and built the HAProxy, Stalwart, and Roundcube containers, let's load up Stalwart's Admin UI by going to http://localhost:7080**
* **If you check the Docker Logs of the Stalwart container, you'll see the initial login credentials provided right there. Log in using those.** * **If you check the Docker Logs of the Stalwart container, you'll see the initial login credentials provided right there. Log in using those.**
@ -232,7 +232,7 @@ docker-compose up -d
* **This is an example of a working Caddyfile. This file tells Caddy what and how to do things. Make the appropriate changes and save it. Then restart Caddy so the changes can be applied.** * **This is an example of a working Caddyfile. This file tells Caddy what and how to do things. Make the appropriate changes and save it. Then restart Caddy so the changes can be applied.**
* **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in the Caddyfile that you can download. It will look a little different than what is in the video but it will work better.** ### **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in the Caddyfile that you can download. It will look a little different than what is in the video but it will work better.**
* **If you changed any IP's or ports in the yml files, they would need to be updated here. Otherwise, this file should be ready to rock n roll.** * **If you changed any IP's or ports in the yml files, they would need to be updated here. Otherwise, this file should be ready to rock n roll.**
@ -252,7 +252,7 @@ docker-compose up -d
* **This is HAProxy's configuration file which tells HAProxy what and how to do everything.** * **This is HAProxy's configuration file which tells HAProxy what and how to do everything.**
* **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in HAProxy's configuration file that you can download. It will look a little different than what is in the video but it will work better.** ### **~ IMPORTANT NOTE ~ Due to Stalwart updating their image, I've made some adjustments in HAProxy's configuration file that you can download. It will look a little different than what is in the video but it will work better.**
* **If you changed any IP's or ports in the yml files, they would need to be updated here. Otherwise, this file should be ready to rock n roll.** * **If you changed any IP's or ports in the yml files, they would need to be updated here. Otherwise, this file should be ready to rock n roll.**
@ -282,6 +282,18 @@ docker-compose up -d
* **After making all the changes so far, you'll now ONLY be able to get to Stalwart's Admin UI and Mail Server via the subdomain you chose. Caddy will route your subdomain request to port 8404. HAProxy will be listening to port 8404 and then route it to 7080.** * **After making all the changes so far, you'll now ONLY be able to get to Stalwart's Admin UI and Mail Server via the subdomain you chose. Caddy will route your subdomain request to port 8404. HAProxy will be listening to port 8404 and then route it to 7080.**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-toml-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture>
</a>
</p>
<br>
<br>
## Stalwart UI SSL Configuration ## Stalwart UI SSL Configuration
* **Settings > TLS > ACME Providers. and make the following changes.** * **Settings > TLS > ACME Providers. and make the following changes.**
@ -300,6 +312,14 @@ docker-compose up -d
* **Save & Reload. Then restar the Stalwart container.** * **Save & Reload. Then restar the Stalwart container.**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-acme-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture>
</a>
</p>
<br> <br>
<br> <br>
@ -331,7 +351,7 @@ docker-compose up -d
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
<img src="URL GOES HERE" alt="IMAGE GOES HERE" width="1280"> <img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-domain-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture> </picture>
</a> </a>
</p> </p>
@ -342,12 +362,52 @@ docker-compose up -d
# Testing Mail Flow # Testing Mail Flow
* **Now we can performa few tests to verify everything works.** **Now we can performa few tests to verify everything works. First thing you'll want to do is log into an email client with your new email address and password. That's what we have Roundcube for. If you followed the instructions up to this point then you should be able to log into Roundcube's UI at webmail.yourdomain.com**
* **Now we can performa few tests to verify everything works.** <p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-roundcube-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture>
</a>
</p>
<br>
<br>
**Once you've successfully logged into an email client, we'll do a test to see if our email address and mail server can receive emails and not give bounce back error messages. There is a great website that can test this that you can use here, https://sendtestemail.com/**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-test-1-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture>
</a>
</p>
<br>
<br>
**Once you successfully receive your test email, we can then test if you can send emails out. There is another website that's great for this that you can use here, https://www.mail-tester.com/**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/mail-server-test-2-scaled.png" alt="IMAGE GOES HERE" width="1280">
</picture>
</a>
</p>
<br>
**If everything went according to the tutorial, you should have recevied a perfect sending score! That means you have a fully functional email server that you can now send and receive emails with for any domain that you own!**
<br> <br>
<H1 align="center">Support the channel so I can make more tutorials!</h1> <H1 align="center">Support the channel so I can make more tutorials!</h1>
<H1 align="center"><a href="https://tip.jhammah.com">If this tutorial helped you out, feel free to buy me a coffee!</a></h1> <H1 align="center"><a href="https://tip.jhammah.com">If this tutorial helped you out, feel free to buy me a coffee!</a></h1>
<br>