From 8428e1a269a71c5bbc8fdaea6e1ee6aa409801ad Mon Sep 17 00:00:00 2001
From: Caleb Braaten <git@cbraaten.dev>
Date: Tue, 20 Feb 2024 13:17:48 -0800
Subject: [PATCH] Add Mailcatcher Service

---
 .../mailcatcher/mailcatcher.nomad.hcl         | 36 +++++++++++++++++++
 nomad_jobs/services/mailcatcher/readme.md     |  7 ++++
 2 files changed, 43 insertions(+)
 create mode 100644 nomad_jobs/services/mailcatcher/mailcatcher.nomad.hcl
 create mode 100644 nomad_jobs/services/mailcatcher/readme.md

diff --git a/nomad_jobs/services/mailcatcher/mailcatcher.nomad.hcl b/nomad_jobs/services/mailcatcher/mailcatcher.nomad.hcl
new file mode 100644
index 0000000..bd6dec9
--- /dev/null
+++ b/nomad_jobs/services/mailcatcher/mailcatcher.nomad.hcl
@@ -0,0 +1,36 @@
+job "mailcatcher" {
+  datacenters = ["dc1"]
+
+  group "mailcatcher" {
+    count = 1
+    
+    network {
+      mode = "bridge"
+      port "webUI" {
+        to = 1080
+      }
+    }
+
+    service {
+      # Make available to other services by the 'fake-smtp' name
+      name = "fake-smtp"
+      port = "1025"
+      tags = ["traefik.enable=false"] # Hide redis from traefik
+
+      connect {
+        sidecar_service {
+          tags = ["traefik.enable=false"] # Hide redis envoy from traefik
+        }
+      }
+    }
+
+    task "mailcatcher" {
+      driver = "docker"
+
+      config {
+        image = "sj26/mailcatcher:latest"
+        ports = ["webUI"]
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/nomad_jobs/services/mailcatcher/readme.md b/nomad_jobs/services/mailcatcher/readme.md
new file mode 100644
index 0000000..25a85c3
--- /dev/null
+++ b/nomad_jobs/services/mailcatcher/readme.md
@@ -0,0 +1,7 @@
+# Mailcatcher
+Mailcatcher is a simple SMTP server that catches all mail sent to it and displays it in a web interface. This is useful for development and testing of email sending services. This is not a production ready service and should not be used in a production environment.
+
+## Nomad Job for Mailcatcher
+Mailcatcher requires no configuration but is only available through the service mesh for sending SMTP mail. The service to connect to is fittingly called `fake-smtp` and is available to the localhost on port `1025`. There is no need for an email or password and the service is not encrypted so you should not use TLS or SSL. (It might work, I just haven't tried it.) - This is not something you should expose to the internet. It's just for testing and development.
+
+Once you have sent an email to the fake SMTP server, you can view the email in the web interface. The web interface has a dynamic port assigned by Nomad so you will need to go to the Task Allocation page in the Nomad UI where you can open the link under 'WebUI' to view the emails.
\ No newline at end of file