EmailConfiguration » History » Version 12

Version 11 (Etienne Massip, 2011-02-02 17:35) → Version 12/55 (Ross Wilson, 2011-10-27 23:55)

h1. Email Configuration

{{>toc}}

h2. Configuration Directives

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

h3. 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)

h3. 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

h4. Asynchronous delivery_methods

The @:async_smtp@ and @:async_sendmail@ use asynchronous sends, which means Redmine does not wait for the email to be sent to display the next page. See "Asynchronous Email Delivery":http://redmineblog.com/articles/asynchronous-email-delivery/ for more details.

h2. Example configuration.yml Configurations

h3. Simple Login Authentication (default settings)

<pre>
# Outgoing email settings

production:
email_delivery:
delivery_method: :smtp
smtp_settings:

smtp_settings:
address: smtp.example.net

port: 25

domain: example.net

authentication: :login

user_name: redmine@example.net

password: redmine

development:
email_delivery:
delivery_method: :smtp
smtp_settings:

smtp_settings:
address: 127.0.0.1

port: 25

domain: example.net

authentication: :login

user_name: redmine@example.net

password: redmine
</pre>

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

<pre>
production:
email_delivery:
delivery_method: :smtp
smtp_settings:

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"

</pre>

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

h3. No Authentication

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

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

h3. Using sendmail command

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

<pre>
production:
delivery_method: :sendmail
</pre>

h2. More information

* "Configuring Action Mailer":http://wiki.rubyonrails.org/howtos/mailers#configuring_action_mailer
* "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration