Email Configuration¶

• Table of contents
• Email Configuration
  • Configuration Directives
    • authentication
    • delivery_method
      • Asynchronous delivery_methods
  • Example email.yml Configurations
    • Simple Login Authentication (default settings)
    • No Authentication
    • Using sendmail command
  • More information

Configuration Directives¶

This page is a work in progress, the following configuration directives is only a partial list.

authentication¶

The type of authentication method expected by your service provider.

Valid settings:

• :login
• :none

(note: if you set this to :none, you must not include the user_name and password settings)

delivery_method¶

The mail transport method to be used.

Valid settings:

• :smtp
• :async_smtp - valid in trunk/0.9+ only
• :sendmail
• :async_sendmail - valid in trunk/0.9+ only

Asynchronous delivery_methods¶

The :async_smtp and :async_sendmail use asynchronous sends, which mean Redmine does not wait for the email to be sent to display the next page. See Asynchronous Email Delivery for more details.

Example email.yml Configurations¶

Simple Login Authentication (default settings)¶

# Outgoing email settings

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.example.net
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

development:
  delivery_method: :smtp
  smtp_settings:
    address: 127.0.0.1
    port: 25
    domain: example.net
    authentication: :login
    user_name: redmine@example.net
    password: redmine

If you want to use GMail/Google Apps and other TLS-requiring SMTP servers, you'll have to add some TLS-related settings :

production:
  delivery_method: :smtp
  smtp_settings:
    tls: true
    enable_starttls_auto: true
    address: "smtp.gmail.com" 
    port: '587'
    domain: "smtp.gmail.com" 
    authentication: :plain
    user_name: "your_email@gmail.com" 
    password: "your_password" 

However, this will only work with "recent" enough ruby and rails versions (1.8.7 patchset 2xx and 2.3.5).
(See #5814 )

No Authentication¶

Example for an SMTP service provider with no authentication. Note the colon before none.

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.knology.net
    port: 25
    domain: cybersprocket.com
    authentication: :none

Using sendmail command¶

Example for a unix system that uses the /usr/sbin/sendmail command.

production:
  delivery_method: :sendmail

More information¶

• Configuring Action Mailer
• Action Mailer Configuration