Moving to mailgun

Author: dutow

app/mailers/application_mailer.rb

@@ -1,4 +1,3 @@
 class ApplicationMailer < ActionMailer::Base
-  default from: "from@example.com"
   layout "mailer"
 end

app/mailers/user_mailer.rb

@@ -1,6 +1,4 @@
 class UserMailer < ApplicationMailer
-  default from: ENV.fetch('MAIL_FROM', 'no-reply@localhost')
-
   def verification_email(token, raw)
     @token_url = verification_url(token: raw)
     mail to: token.email, subject: 'Verify your email'

config/environments/production.rb

@@ -57,28 +57,37 @@
 
   # Raise delivery errors in production
   config.action_mailer.raise_delivery_errors = true
+  config.action_mailer.perform_deliveries = true
   config.action_mailer.delivery_method = :smtp
 
   # Set host to be used by links generated in mailer templates.
   config.action_mailer.default_url_options = {
-    host: ENV.fetch("APP_HOST", "example.com"),
+    host: ENV.fetch("APP_HOST", "hackorum.dev"),
     protocol: "https"
   }
 
   # Default from address for all mailers
   config.action_mailer.default_options = {
-    from: ENV.fetch("MAIL_FROM", "noreply@example.com")
+    from: ENV.fetch("MAIL_FROM", "noreply@hackorum.dev")
   }
 
-  # SMTP server configuration
+  # SMTP server configuration (Mailgun)
+  smtp_username = ENV["SMTP_USERNAME"]
+  smtp_password = ENV["SMTP_PASSWORD"]
+
+  if smtp_username.blank? || smtp_password.blank?
+    Rails.logger.warn "WARNING: SMTP_USERNAME or SMTP_PASSWORD not configured. Email delivery will fail!"
+    Rails.logger.warn "Set these in deploy/.env for production email delivery."
+  end
+
   config.action_mailer.smtp_settings = {
-    address: ENV.fetch("SMTP_ADDRESS", "mail"),
+    address: ENV.fetch("SMTP_ADDRESS", "smtp.eu.mailgun.org"),
     port: ENV.fetch("SMTP_PORT", "587").to_i,
-    domain: ENV.fetch("SMTP_DOMAIN", "example.com"),
-    # No authentication needed for internal mail server
-    authentication: nil,
-    enable_starttls_auto: false,
-    openssl_verify_mode: "none"
+    domain: ENV.fetch("SMTP_DOMAIN", "hackorum.dev"),
+    user_name: smtp_username,
+    password: smtp_password,
+    authentication: :plain,
+    enable_starttls_auto: true
   }
 
   # Enable locale fallbacks for I18n (makes lookups for any locale fall back to

deploy/.env.example

@@ -29,19 +29,17 @@ GOOGLE_REDIRECT_URI=https://hackorum.example.com/auth/google_oauth2/callback
 # Hostname for Caddy (update deploy/Caddyfile too)
 APP_HOST=hackorum.example.com
 
-# Mail configuration
-MAIL_DOMAIN=example.com
-MAIL_HOSTNAME=mail.example.com
-MAIL_FROM=noreply@example.com
-DKIM_SELECTOR=mail
-
-# Optional: Use a relay host (e.g., SendGrid, Mailgun) instead of direct sending
-# This is recommended for better deliverability
-# MAIL_RELAYHOST=[smtp.sendgrid.net]:587
-# MAIL_RELAYHOST_USERNAME=apikey
-# MAIL_RELAYHOST_PASSWORD=your-sendgrid-api-key
-
-# SMTP settings for Rails
-SMTP_ADDRESS=mail
+# Mail configuration via Mailgun
+# Sign up at https://mailgun.com and verify your domain (use subdomain mg.example.com)
+# Get credentials from Mailgun dashboard → Sending → Domain settings → SMTP credentials
+MAIL_DOMAIN=mg.example.com
+MAIL_FROM=noreply@mg.example.com
+
+# Mailgun SMTP settings
+# EU region (GDPR compliant): smtp.eu.mailgun.org
+# US region: smtp.mailgun.org
+SMTP_ADDRESS=smtp.eu.mailgun.org
 SMTP_PORT=587
-SMTP_DOMAIN=example.com
+SMTP_DOMAIN=hackorum.dev
+SMTP_USERNAME=usernamee@hackorum.dev
+SMTP_PASSWORD=your-mailgun-smtp-password

deploy/docker-compose.yml

@@ -41,6 +41,15 @@ services:
       PGPASSWORD: ${POSTGRES_PASSWORD:-postgres}
       PGDATABASE: ${POSTGRES_DB:-hackorum}
       SECRET_KEY_BASE: ${SECRET_KEY_BASE}
+      # Mail configuration
+      APP_HOST: ${APP_HOST}
+      MAIL_DOMAIN: ${MAIL_DOMAIN}
+      MAIL_FROM: ${MAIL_FROM}
+      SMTP_ADDRESS: ${SMTP_ADDRESS}
+      SMTP_PORT: ${SMTP_PORT}
+      SMTP_DOMAIN: ${SMTP_DOMAIN}
+      SMTP_USERNAME: ${SMTP_USERNAME}
+      SMTP_PASSWORD: ${SMTP_PASSWORD}
     depends_on:
       db:
         condition: service_healthy
@@ -102,54 +111,6 @@ services:
       - /var/run/docker.sock:/var/run/docker.sock
     restart: unless-stopped
 
-  mail:
-    image: boky/postfix:latest
-    hostname: ${MAIL_HOSTNAME:-mail.example.com}
-    environment:
-      # Domain from which emails will be sent
-      ALLOWED_SENDER_DOMAINS: ${MAIL_DOMAIN:-example.com}
-
-      # Relay host (leave empty for direct sending, or use a relay like SendGrid/Mailgun)
-      # RELAYHOST: ${MAIL_RELAYHOST:-}
-      # RELAYHOST_USERNAME: ${MAIL_RELAYHOST_USERNAME:-}
-      # RELAYHOST_PASSWORD: ${MAIL_RELAYHOST_PASSWORD:-}
-
-      # DKIM signing
-      DKIM_SELECTOR: ${DKIM_SELECTOR:-mail}
-      DKIM_AUTOGENERATE: "true"
-
-      # Logging
-      LOG_LEVEL: ${MAIL_LOG_LEVEL:-info}
-
-      # Override from address (optional, for testing)
-      # OVERWRITE_FROM: ${MAIL_OVERWRITE_FROM:-}
-
-      # TLS configuration
-      TLS: "true"
-
-      # Allow localhost relay (for the web container)
-      ALLOW_EMPTY_SENDER_DOMAINS: "false"
-
-      # Message size limit (default 10MB)
-      MESSAGE_SIZE_LIMIT: ${MAIL_MESSAGE_SIZE_LIMIT:-10240000}
-    volumes:
-      # Persist DKIM keys
-      - mail_dkim:/etc/opendkim/keys
-      # Persist mail queue
-      - mail_spool:/var/spool/postfix
-    expose:
-      - "587"  # Submission port (for authenticated clients)
-    ports:
-      - "25:25"   # SMTP port (for receiving mail)
-    healthcheck:
-      test: ["CMD-SHELL", "postfix status || exit 1"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-    restart: unless-stopped
-    labels:
-      autoheal: "true"
-
   psql:
     image: postgres:18
     entrypoint: ["psql", "postgresql://${POSTGRES_USER:-postgres}:${POSTGRES_PASSWORD:-postgres}@db:5432/${POSTGRES_DB:-hackorum}"]
@@ -165,5 +126,3 @@ volumes:
   pgbackups:
   caddy_data:
   caddy_config:
-  mail_dkim:
-  mail_spool: