Project

General

Profile

EmailConfiguration » History » Version 4

Anthony Cartmell, 2009-07-30 18:49
Added comment that authentication :none fails if user_name and password are also specified.

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 1 Cyber Sprocket
25
26
h2. Example email.yml Configurations
27
28
h3. Simple Login Authentication (default settings)
29
30
<pre>
31
# Outgoing email settings
32
33
production:
34
  delivery_method: :smtp
35
  smtp_settings:
36
    address: smtp.example.net
37
    port: 25
38
    domain: example.net
39
    authentication: :login
40
    user_name: redmine@example.net
41
    password: redmine
42
  
43
development:
44
  delivery_method: :smtp
45
  smtp_settings:
46
    address: 127.0.0.1
47
    port: 25
48
    domain: example.net
49
    authentication: :login
50
    user_name: redmine@example.net
51
    password: redmine
52
</pre>
53
54
55
h3. No Authentication
56
57
Example for an SMTP service provider with no authentication.  Note the colon before none.
58
59
<pre>
60
production:
61
  delivery_method: :smtp
62
  smtp_settings:
63
    address: smtp.knology.net
64
    port: 25
65
    domain: cybersprocket.com
66
    authentication: :none
67
</pre>