Project

General

Profile

EmailConfiguration » History » Version 5

Eric Davis, 2009-09-15 05:56
Added more information about the sendmail option

1 1 Cyber Sprocket
h1. Email Configuration
2
3
h2. Configuration Directives
4
5
This page is a work in progress, the following configuration directives is only a partial list.
6
7
h3. authentication
8
9
The type of authentication method expected by your service provider. 
10
11
Valid settings:
12
* :login
13
* :none
14
15 4 Anthony Cartmell
(note: if you set this to @:none@, you must not include the @user_name@ and @password@ settings)
16
17 1 Cyber Sprocket
h3. delivery_method
18
19 3 Philippe Creux
The mail transport method to be used. @:async_smtp@ uses asynchronous send. Redmine does not wait the email to be sent to display the next page.
20 1 Cyber Sprocket
21
Valid settings:
22
* :smtp
23 2 Philippe Creux
* :async_smtp
24 5 Eric Davis
* :sendmail
25
* :async_sendmail
26 1 Cyber Sprocket
27
28
h2. Example email.yml Configurations
29
30
h3. Simple Login Authentication (default settings)
31
32
<pre>
33
# Outgoing email settings
34
35
production:
36
  delivery_method: :smtp
37
  smtp_settings:
38
    address: smtp.example.net
39
    port: 25
40
    domain: example.net
41
    authentication: :login
42
    user_name: redmine@example.net
43
    password: redmine
44
  
45
development:
46
  delivery_method: :smtp
47
  smtp_settings:
48
    address: 127.0.0.1
49
    port: 25
50
    domain: example.net
51
    authentication: :login
52
    user_name: redmine@example.net
53
    password: redmine
54
</pre>
55
56
57
h3. No Authentication
58
59
Example for an SMTP service provider with no authentication.  Note the colon before none.
60
61
<pre>
62
production:
63
  delivery_method: :smtp
64
  smtp_settings:
65
    address: smtp.knology.net
66
    port: 25
67
    domain: cybersprocket.com
68
    authentication: :none
69
</pre>
70 5 Eric Davis
71
h3. Using sendmail command
72
73
Example for a unix system that uses the @/usr/sbin/sendmail@ command.
74
75
<pre>
76
production:
77
  delivery_method: :sendmail
78
</pre>
79
80
h3. More information
81
82
* "Configuring Action Mailer":http://wiki.rubyonrails.org/howtos/mailers#configuring_action_mailer
83
* "Action Mailer Configuration":http://guides.rubyonrails.org/action_mailer_basics.html#action-mailer-configuration