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 Testendeliver_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 nachdelivery_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.