From 49b7b0d83b3890d3a9bb41bb3c2df022aec0ee2a Mon Sep 17 00:00:00 2001
From: Agent <agent@lorentz.is>
Date: Thu, 10 Sep 2026 11:30:50 -0400
Subject: [PATCH] Align README, docker-compose, .env.template with SMTP mailer
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Replace all Postmark references (POSTMARK_API_KEY, POSTMARK_SENDER_ADDRESS)
with SMTP configuration (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD,
SMTP_FROM) across documentation, deployment config, template, and test.

- README.md: architecture diagram (Postmark → SMTP) and configuration table
- docker-compose.yml: POSTMARK_* env vars replaced with SMTP_* required vars
- .env.template: POSTMARK_* entries replaced with SMTP_* entries
- test/integration.sh: POSTMARK_* test exports replaced with SMTP_* test values
---
 .env.template       | 7 +++++--
 README.md           | 9 ++++++---
 docker-compose.yml  | 7 +++++--
 test/integration.sh | 7 +++++--
 4 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/.env.template b/.env.template
index 885b96f..4f469f2 100644
--- a/.env.template
+++ b/.env.template
@@ -5,7 +5,10 @@ BASE_URL=http://localhost:4738
 INDEXER_RELAYS=purplepag.es,relay.damus.io,relay.nostr.band
 DEFAULT_RELAYS=relay.damus.io,nos.lol
 SEARCH_RELAYS=relay.nostr.band
-POSTMARK_API_KEY=
-POSTMARK_SENDER_ADDRESS=
+SMTP_HOST=
+SMTP_PORT=
+SMTP_USER=
+SMTP_PASSWORD=
+SMTP_FROM=
 PORT=4738
 DATA_DIR=./data
diff --git a/README.md b/README.md
index 563d760..a7d388a 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@ Flotilla ──HTTP──▶ Mailship (POST /subscription/email)
                            UUID in path      ├── fetch event from relay
                            is the auth       ├── store in SQLite (dedup)
                                              │
-                                        cron fires ──▶ render digest ──▶ Postmark ──▶ email
+                                        cron fires ──▶ render digest ──▶ SMTP ──▶ email
 ```
 
 ## Configuration
@@ -30,8 +30,11 @@ Flotilla ──HTTP──▶ Mailship (POST /subscription/email)
 | `MAILSHIP_NAME` | ✓ | Name of this Mailship instance |
 | `MAILSHIP_URL` | ✓ | Public URL of this instance |
 | `BASE_URL` | ✓ | Base URL for callback URLs (same as MAILSHIP_URL typically) |
-| `POSTMARK_API_KEY` | ✓ | Postmark API key for sending emails |
-| `POSTMARK_SENDER_ADDRESS` | ✓ | Verified sender email in Postmark |
+| `SMTP_HOST` | ✓ | SMTP server hostname |
+| `SMTP_PORT` | ✓ | SMTP server port |
+| `SMTP_USER` | ✓ | SMTP username |
+| `SMTP_PASSWORD` | ✓ | SMTP password |
+| `SMTP_FROM` | ✓ | From email address for outgoing mail |
 | `DEFAULT_RELAYS` | ✓ | Comma-separated list of default relays |
 | `INDEXER_RELAYS` | ✓ | Comma-separated list of indexer relays |
 | `SEARCH_RELAYS` | ✓ | Comma-separated list of search relays |
diff --git a/docker-compose.yml b/docker-compose.yml
index 1d172dd..10eac1b 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -10,8 +10,11 @@ services:
       - MAILSHIP_NAME=${MAILSHIP_NAME:-Mailship}
       - MAILSHIP_URL=${MAILSHIP_URL:?required}
       - BASE_URL=${BASE_URL:?required}
-      - POSTMARK_API_KEY=${POSTMARK_API_KEY:?required}
-      - POSTMARK_SENDER_ADDRESS=${POSTMARK_SENDER_ADDRESS:?required}
+      - SMTP_HOST=${SMTP_HOST:?required}
+      - SMTP_PORT=${SMTP_PORT:?required}
+      - SMTP_USER=${SMTP_USER:?required}
+      - SMTP_PASSWORD=${SMTP_PASSWORD:?required}
+      - SMTP_FROM=${SMTP_FROM:?required}
       - DEFAULT_RELAYS=${DEFAULT_RELAYS:-wss://relay.damus.io,wss://relay.primal.net}
       - INDEXER_RELAYS=${INDEXER_RELAYS:-wss://purplepag.es,wss://relay.damus.io}
       - SEARCH_RELAYS=${SEARCH_RELAYS:-wss://relay.nostr.band}
diff --git a/test/integration.sh b/test/integration.sh
index 88dcc3a..e6f629a 100755
--- a/test/integration.sh
+++ b/test/integration.sh
@@ -46,8 +46,11 @@ export MAILSHIP_SECRET="$SECRET"
 export MAILSHIP_NAME="Mailship Test"
 export MAILSHIP_URL="$BASE_URL"
 export BASE_URL="$BASE_URL"
-export POSTMARK_API_KEY="test"
-export POSTMARK_SENDER_ADDRESS="test@test.com"
+export SMTP_HOST="localhost"
+export SMTP_PORT="587"
+export SMTP_USER="test@test.com"
+export SMTP_PASSWORD="test"
+export SMTP_FROM="test@test.com"
 export DEFAULT_RELAYS="wss://relay.damus.io"
 export INDEXER_RELAYS="wss://purplepag.es"
 export SEARCH_RELAYS="wss://relay.nostr.band"