Add maildev container for debugging emails (#22425)

Co-authored-by: Pascal Jufer <pascal-jufer@bluewin.ch>

docker-compose.yml

@@ -1,10 +1,20 @@
-# This compose file is meant to spin up a copy of all supported database vendors + Redis and S3 (Minio).
-# For production use see the docker compose file example in the docs:
-#     https://docs.directus.io/self-hosted/docker-guide.html#example-docker-compose
+# This compose file is meant to spin up a copy of supported database vendors,
+# Redis, S3 (Minio) and a fake SMTP server (MailDev).
 #
 # ONLY FOR DEBUGGING. THIS IS NOT INTENDED FOR PRODUCTION USE.
 #
+# For production use see the docker compose file example in the docs:
+#     https://docs.directus.io/self-hosted/docker-guide.html#example-docker-compose
+#
+# For receiving emails via MailDev, you'll need to add the following to your env:
+#   EMAIL_FROM=directus@directus.io
+#   EMAIL_TRANSPORT=smtp
+#   EMAIL_SMTP_HOST=0.0.0.0
+#   EMAIL_SMTP_PORT=1025
+#
 # Ports:
+#   Maildev SMTP:    1025
+#   Maildev Web-UI:  1080
 #   Postgres:        5100
 #   MySQL (8):       5101
 #   MariaDB:         5102
@@ -158,3 +168,9 @@ services:
       DB_VENDOR: h2
     ports:
       - 5110:8080
+
+  maildev:
+    image: maildev/maildev
+    ports:
+      - 1025:1025
+      - 1080:1080

docs/contributing/running-locally.md

@@ -59,7 +59,7 @@ mandatory in production.
 
 Also the [Database Configuration](https://docs.directus.io/self-hosted/config-options.html#database) must be specified.
 You might want to use the [docker-compose.yml](https://github.com/directus/directus/blob/main/docker-compose.yml) file
-to spin up a test database.
+to spin up a test database or a local mail server.
 
 :::