EmailConfiguration » History » Version 29
- Email Configuration
This page is a work in progress, the following configuration directives are only a partial list.
The type of authentication method expected by your service provider.Valid settings:
(note: if you set this to
:none, you must not include the
The mail transport method to be used.Valid settings:
: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 for more details. Some SMTP servers have delay period before processing as security feature, during which time synchronous method will block Redmine (10 seconds could be default value, see also #11376 for more information) .
With this delivery method, smtp configuration is specified using
development: email_delivery: delivery_method: :async_smtp async_smtp_settings: ...
Example configuration.yml Configurations¶
Simple Login Authentication (default settings)¶
# Outgoing email settings production: email_delivery: delivery_method: :smtp smtp_settings: address: smtp.example.net port: 25 domain: example.net authentication: :login user_name: firstname.lastname@example.org password: redmine development: email_delivery: delivery_method: :smtp smtp_settings: address: 127.0.0.1 port: 25 domain: example.net authentication: :login user_name: email@example.com password: redmine
If you want to use GMail/Google Apps and other TLS-requiring SMTP servers, you'll have to add some TLS-related settings :
production: email_delivery: delivery_method: :smtp smtp_settings: enable_starttls_auto: true address: "smtp.gmail.com" port: '587' domain: "smtp.gmail.com" authentication: :plain user_name: "firstname.lastname@example.org" password: "your_password"
However, this will only work with "recent" enough ruby and rails versions (1.8.7 patchset 2xx and 2.3.5).
(See #5814 )
Example for an SMTP service provider with no authentication. Note the colon before none.
production: email_delivery: delivery_method: :smtp smtp_settings: address: smtp.knology.net port: 25 domain: cybersprocket.com authentication: :none
Using sendmail command¶
Example for a unix system that uses the
production: email_delivery: delivery_method: :sendmail