Setup ActionMailer

Related: YAML Mail Config?

We will use GMail as our SMTP server to setup ActionMailer. This instruction is based on the following pages:

ActionMailer can't send emails using GMail out of the box. To add this functionality:

  1. Create the file lib/smtp_tls.rb
    require "openssl"
    require "net/smtp"
    
    # http://blog.pomozov.info/posts/how-to-send-actionmailer-mails-to-gmailcom.html
    
    Net::SMTP.class_eval do
      private
      def do_start(helodomain, user, secret, authtype)
        raise IOError, 'SMTP session already started' if @started
        check_auth_args user, secret, authtype if user or secret
    
        sock = timeout(@open_timeout) { TCPSocket.open(@address, @port) }
        @socket = Net::InternetMessageIO.new(sock)
        @socket.read_timeout = 60 #@read_timeout
    
        check_response(critical { recv_response() })
        do_helo(helodomain)
    
        raise 'openssl library not installed' unless defined?(OpenSSL)
        starttls
        ssl = OpenSSL::SSL::SSLSocket.new(sock)
        ssl.sync_close = true
        ssl.connect
        @socket = Net::InternetMessageIO.new(ssl)
        @socket.read_timeout = 60 #@read_timeout
        do_helo(helodomain)
    
        authenticate user, secret, authtype if user
        @started = true
      ensure
        unless @started
          # authentication failed, cancel connection.
          @socket.close if not @started and @socket and not @socket.closed?
          @socket = nil
        end
      end
    
      def do_helo(helodomain)
         begin
          if @esmtp
            ehlo helodomain
          else
            helo helodomain
          end
        rescue Net::ProtocolError
          if @esmtp
            @esmtp = false
            @error_occured = false
            retry
          end
          raise
        end
      end
    
      def starttls
        getok('STARTTLS')
      end
    
      def quit
        begin
          getok('QUIT')
        rescue EOFError
        rescue OpenSSL::SSL::SSLError
        end
      end
    end
    
  2. Add the following lines to config/environment.rb and replace the values with the appropriate username and password:
    require 'smtp_tls'
    ActionMailer::Base.server_settings = {
      :address => "smtp.gmail.com",
      :port => 587,
      :domain => "mycompany.com",
      :authentication => :plain,
      :user_name => "username",
      :password => "password"
    }
    
  3. Edit app/models/user_mailer.rb.
    • Make sure to replace the value of @from within the method setup_email(user) with the GMail address in the ActionMailer settings.