Rails-E-Mails lokal auf Ihrem Mac testen

Jede Action-Mailer-E-Mail Ihrer Rails-App an einen lokalen SMTP-Server auf dem Mac senden. development.rb in einer Minute einrichten, jede E-Mail sofort prüfen.

Standardmäßig versucht Rails im Development-Modus, per SMTP zuzustellen, und ignoriert Zustellfehler stillschweigend — E-Mails sehen Sie also nur im Log. Für einen schnellen Blick reicht das, mühsam wird es aber, sobald Sie das tatsächliche HTML sehen müssen. Mit Mailbox stellt Action Mailer an einen lokalen SMTP-Server auf Ihrem Mac zu, und jede E-Mail erscheint gerendert, mit Headern, Klartext-Teil und Anhängen. In einem echten Posteingang kommt nichts an.

1. Server in Mailbox starten

Öffnen Sie Mailbox. Beim ersten Start legt Mailbox einen Server auf Port 2525 an — stellen Sie sicher, dass er gestartet ist. Wenn Sie stattdessen einen weiteren Server hinzufügen, wählt Mailbox dafür einen freien Port; verwenden Sie dann diesen Port in den folgenden Schritten.

2. Action Mailer konfigurieren

In config/environments/development.rb:

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: "127.0.0.1",
  port: 2525
}
config.action_mailer.raise_delivery_errors = true
config.action_mailer.default_url_options = { host: "localhost", port: 3000 }

Mailbox verwendet weder SMTP-Authentifizierung noch TLS, lassen Sie user_name, password und authentication also weg. raise_delivery_errors sorgt dafür, dass ein falscher Port laut statt still fehlschlägt, und default_url_options lässt Links in Ihren E-Mails auf Ihre lokale App zeigen.

Starten Sie den Rails-Server neu, nachdem Sie Environment-Dateien geändert haben.

3. Test-E-Mail senden

Am schnellsten prüfen Sie das mit einer einmaligen E-Mail über den Runner:

bin/rails runner 'ActionMailer::Base.mail(from: "app@example.com", to: "test@example.com", subject: "Hello from Rails", body: "It works!").deliver_now'

Lösen Sie danach einen echten Mailer aus — registrieren Sie sich, setzen Sie ein Passwort zurück —, und die E-Mail landet im selben Posteingang.

Rails in Docker betreiben

In einem Container ist 127.0.0.1 der Container selbst. Richten Sie Action Mailer stattdessen auf Ihren Mac aus:

config.action_mailer.smtp_settings = { address: "host.docker.internal", port: 2525 }

Falls der Container weiterhin keine Verbindung herstellen kann, aktivieren Sie in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu, damit er auch Verbindungen von außerhalb des Loopback-Interfaces annimmt.

Fehlerbehebung

  • Errno::ECONNREFUSED — der Mailbox-Server läuft nicht, oder der Port stimmt nicht überein.
  • Nichts kommt an, kein Fehler — deliver_later-Jobs brauchen einen laufenden Queue-Adapter (Solid Queue, Sidekiq …). Verwenden Sie beim Testen deliver_now, oder starten Sie Ihren Job-Worker.
  • E-Mails erscheinen weiterhin nur im Konsolen-Log — eine andere Environment-Datei oder ein Initializer überschreibt delivery_method; durchsuchen Sie das Projekt nach delivery_method.

Als Nächstes prüfen

Mailbox zeigt, wie sich Ihre Templates jenseits des Browsers schlagen: Die HTML-Kompatibilitätsprüfung markiert CSS, das Outlook oder Gmail ignorieren, und die Mobilvorschau zeigt die E-Mail in einem Viewport in Smartphone-Größe. Mailer-Previews (/rails/mailers) bleiben ideal, um an einem einzelnen Template zu feilen; Mailbox fängt ab, was Ihre App im kompletten Ablauf tatsächlich verschickt.

Weitere Anleitungen