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