Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
86 lines (50 sloc) 2.57 KB

Dead Letter Office

Build Status Code Climate

Dead Letter Office


This project implements a Dead letter office (mail recovery center) as an engine for your Rails 3 application. Undeliverable emails which raise exceptions will be logged to the database and can be viewed via a mountable web interface.


Supported Platforms

Dead letter office is currently being developed against the following stack:


  • Ruby 1.9.2
  • Ruby 1.9.3
  • JRuby 1.6+ (1.9 mode) (passes locally, fails on Travis CI)
  • Rubinius 2.0 (1.9 mode) (I am anxiously awaiting passable 1.9 support)


  • Rails 3.2.x

It is possible that this may work on older versions of Rails. I do not have any plans to support older versions of Ruby.


  • Add dead_letter_office to your Gemfile
gem "dead_letter_office"
  • Run bundle
  • Copy the migrations and prepare your databases:
rake dead_letter_office:install:migrations db:migrate db:test:prepare
  • Mount the web interface in your config/routes.rb file:
namespace :admin do
  mount DeadLetterOffice::Engine => "/dead_letter_office"

Using the example above, you may now view the UI at


  • add http authentication
  • retry message delivery
  • clear all failures
  • customizable alert notifications


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request



Dead Letter Office