Project

General

Profile

EmailConfiguration » History » Version 34

Anonymous, 2013-03-18 10:14
Fix list of authentication types

1 1 Cyber Sprocket
h1. Email Configuration
2
3 7 Mischa The Evil
{{>toc}}
4
5 31 Miodrag Milic
6 1 Cyber Sprocket
h2. Configuration Directives
7
8 34 Anonymous
This page is a work in progress, the following configuration directives are only a partial list. Please consult "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration
9
for detailed information.
10 1 Cyber Sprocket
11
h3. authentication
12
13
The type of authentication method expected by your service provider. 
14
15
Valid settings:
16 34 Anonymous
* @nil@ (or omit the key) for no authentication
17
* @:plain@
18
* @:login@
19
* @:cram_md5@
20 1 Cyber Sprocket
21 34 Anonymous
(note: if you set this to @nil@ or omit it, you must not include the @user_name@ and @password@ settings)
22 1 Cyber Sprocket
23
h3. delivery_method
24
25 6 Eric Davis
The mail transport method to be used.
26 1 Cyber Sprocket
27
Valid settings:
28 34 Anonymous
* @:smtp@
29
* :@sendmail@
30
* @:async_smtp@
31
* @:async_sendmail@
32 1 Cyber Sprocket
33 6 Eric Davis
h4. Asynchronous delivery_methods
34
35 30 Miodrag Milic
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. Some SMTP servers have delay period before processing takes place as anti-spam feature, during which time synchronous method will block Redmine ("10 seconds":http://answers.bitnami.org/questions/4421/updating-an-issue-in-redmine-takes-10-seconds could be default value, see also #11376 for more information) .
36 1 Cyber Sprocket
37 23 Miodrag Milic
With this delivery method, smtp configuration is specified using @async_smtp_settings@ keyword:
38
39
<pre>
40
development:
41
  email_delivery:
42
    delivery_method: :async_smtp
43
    async_smtp_settings:
44
    ...
45
</pre>
46
47 11 Etienne Massip
h2. Example configuration.yml Configurations
48 1 Cyber Sprocket
49
h3. Simple Login Authentication (default settings)
50
51
<pre>
52
# Outgoing email settings
53
54
production:
55 12 Ross Wilson
  email_delivery:
56
    delivery_method: :smtp
57
    smtp_settings:
58
      address: smtp.example.net
59
      port: 25
60
      domain: example.net
61
      authentication: :login
62
      user_name: redmine@example.net
63
      password: redmine
64 1 Cyber Sprocket
  
65
development:
66 12 Ross Wilson
  email_delivery:
67
    delivery_method: :smtp
68
    smtp_settings:
69
      address: 127.0.0.1
70
      port: 25
71
      domain: example.net
72
      authentication: :login
73
      user_name: redmine@example.net
74
      password: redmine
75 1 Cyber Sprocket
</pre>
76
77
78
*If you want to use GMail/Google Apps and other TLS-requiring SMTP servers*, you'll have to add some TLS-related settings :
79 8 Joël Lamotte
80
<pre>
81
production:
82 12 Ross Wilson
  email_delivery:
83
    delivery_method: :smtp
84
    smtp_settings:
85
      enable_starttls_auto: true
86
      address: "smtp.gmail.com" 
87
      port: '587'
88
      domain: "smtp.gmail.com" 
89
      authentication: :plain
90
      user_name: "your_email@gmail.com" 
91 1 Cyber Sprocket
      password: "your_password" 
92 8 Joël Lamotte
93
</pre>
94
95
However, this will only work with "recent" enough ruby and rails versions (1.8.7 patchset 2xx and 2.3.5).
96
(See #5814 )
97
98 1 Cyber Sprocket
h3. No Authentication
99
100 34 Anonymous
Example for an SMTP service provider with no authentication.
101 1 Cyber Sprocket
102
<pre>
103 13 Ross Wilson
production:
104
  email_delivery:
105
    delivery_method: :smtp
106
    smtp_settings:
107
      address: smtp.knology.net
108
      port: 25
109
      domain: cybersprocket.com
110 1 Cyber Sprocket
</pre>
111
112
h3. Using sendmail command
113 5 Eric Davis
114
Example for a unix system that uses the @/usr/sbin/sendmail@ command.
115
116
<pre>
117
production:
118 13 Ross Wilson
  email_delivery:
119
    delivery_method: :sendmail
120 5 Eric Davis
</pre>
121 1 Cyber Sprocket
122 7 Mischa The Evil
h2. More information
123 5 Eric Davis
124
* "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration