Project

General

Profile

EmailConfiguration » History » Revision 7

Revision 6 (Eric Davis, 2009-10-09 19:23) → Revision 7/58 (Mischa The Evil, 2010-07-17 19:42)

h1. Email Configuration 

 {{>toc}} 

 h2. Configuration Directives 

 This page is a work in progress, the following configuration directives is 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 mean 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 email.yml Configurations 

 h3. Simple Login Authentication (default settings) 

 <pre> 
 # 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 
 </pre> 


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