Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
RESTful email for Rails 2.3
Ruby
Branch: master

This branch is 18 commits ahead, 4 commits behind maccman:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
.gitignore
MIT-LICENSE
README.markdown
Rakefile
VERSION
remail-rails2.gemspec

README.markdown

Remail is RESTful email for Rails.

Forget configuring SMTP servers and queues, just use Remail. Remail uses Google App Engine to send and receive emails RESTfully.

This gem (remail-rails2) only supports Rails 2.3

Google App Engine gives you a free quota of 2000 emails per day or, with the paid version, 7,400,000 emails per day.

Features

  • ActionMailer POSTs emails to your Remail App Engine in order to send them
  • Remail POSTs received emails back to a configurable URL
  • Remail will retry the callback if the endpoint is not available

Setup

  • Configure and deploy the Remail App Engine
  • Install the Remail gem (sudo gem install remail-rails2)

Sending email

Configure ActionMailer and Remail:

config.action_mailer.delivery_method = :remail
Remail.app_id  = "remail-appname"
Remail.api_key = "changeme"

The sender address of a message must be the email address of an administrator for the Remail App Engine. If you want to send email on behalf of the application but do not want to use a single administrator's personal Google Account as the sender, you can create a new Google Account for the application using any valid email address, then add the new account as an administrator for the application.

Misc

To ensure your email doesn't get caught in spam filters, you should follow the tips in this tutorial I wrote - the important points being setting SPF and MX records.

Something went wrong with that request. Please try again.