MCLOUD-6898: Add option to customize port for MailHog (#7860)

* MCLOUD-6898: Add option to customize port for MailHog
* MCLOUD-6660: Add option to disable MailHog
* Update src/cloud/docker/docker-config.md

Co-authored-by: Margaret Eker <[email protected]>

Author: BaDos

src/cloud/docker/docker-config.md

@@ -107,6 +107,20 @@ The default {{ site.data.var.mcd-prod }} configuration includes the [MailHog] se
 
 When the MailHog service is installed, go to the following URL to open the service and view outgoing emails: `http://magento2.docker:8025`
 
+By default, MailHog listens on port 1025 for SMTP and port 8025 for the frontend dashboard and API. You can change the default ports using the `--mailhog-http-port` and `--mailhog-smtp-port` options.
+
+```bash
+./vendor/bin/ece-docker build:compose --mailhog-smtp-port=1026 --mailhog-http-port=8026
+```
+
+After updating the configuration and restarting the Docker environment, you can connect to the MailHog service from `http://magento2.docker:8026`, and use port 1026 for SMTP communication.
+
+If you do not need the [MailHog] service, use the `--no-mailhog` option to generate the Docker compose configuration: 
+
+```bash
+./vendor/bin/ece-docker build:compose --no-mailhog
+```
+
 [php]: https://www.php.net/manual/en/install.php
 [Composer]: https://getcomposer.org
 [Docker]: https://www.docker.com/get-started

src/cloud/docker/docker-quick-reference.md

@@ -51,6 +51,7 @@ docker-compose -f docker-compose.yml -f docker-compose-custom.yml [-f more-custo
 | [Mode][]         | `--mode`, `-m`   | production, developer
 | [File synchronization engine][] | `--sync-engine` | native (default), docker-sync, mutagen
 | Specify a custom URL for Magento | `--host`<br>`--port`
+| Specify custom HTTP and SMTP ports for MailHog | `--mailhog-http-port`<br>`--mailhog-smtp-port`
 
 {:.bs-callout-info}
 See [Service versions] for a list of service configuration options you can add to the `ece-docker build:compose` command to customize the Cloud Docker environment configuration.