brandonh317/smtp-relay repository overview

⁠Simple SMTP Relay for Amazon SES

A lightweight, secure Postfix-based SMTP relay designed to forward emails from your internal services (like Tandoor, Jellyfin, or Pi-hole) to Amazon SES. Built on Alpine Linux for a minimal footprint.

⁠🚀 Features

• Lightweight: Built on alpine:latest, minimal resource usage.
• Secure by Default: Configured to only accept mail from private IP ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16).
• SES Integration: Pre-configured for Amazon SES with STARTTLS.
• Health Checks: Includes netcat based health monitoring.
• No Local Auth: Designed for internal trusted networks; no SASL auth required for clients connecting to port 25.

⁠📋 Quick Start

⁠Docker CLI

docker run -d \
  --name smtp-relay \
  -p 25:25 \
  -e SES_SMTP_USERNAME=your_ses_key \
  -e SES_SMTP_PASSWORD=your_ses_secret \
  -e SES_SMTP_HOST=email-smtp.us-east-1.amazonaws.com \
  yourusername/smtp-relay:latest

⁠⚙️ Configuration

⁠Example Docker Compose Configuration

services:
  smtp-relay:
    image: brandonh317/smtp-relay:latest
    environment:
      SES_SMTP_HOST: email-smtp.us-east-1.amazonaws.com
      SES_SMTP_PORT: 587
      SES_SMTP_USERNAME: your_ses_access_key
      SES_SMTP_PASSWORD: your_ses_secret_key
      RELAY_HOST: 0.0.0.0
      RELAY_PORT: 25
      LOG_LEVEL: INFO