Configuration for email notifications

In order to have Easy Project send notifications about new tasks, task updates, and all other selected events, you need to connect the application to a mail server. E-mail configuration settings can be found in the file configuration.yml ([easyproject root]/config/configuration.yml). After making any changes in this configuration file, you will need to restart the application server for them to take effect. Test whether your configuration is correct in Administration » Settings » Email notifications – Send a test email.

Here follow 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: "easyproject@example.net"
      password: "easyproject"

development:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "127.0.0.1"
      port: '25'
      domain: example.net
      authentication: :login
      user_name: "easyproject@example.net"
      password: "easyproject"

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: "your_email@gmail.com" 
      password: "your_password" 

Here is an example for Office 365 users (Exchange online). The sender must have an account, or if you want to send from a shared mailbox, the account below must have authorization to "Send As" the sender which is defined in Easy Project email notifications settings.

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      enable_starttls_auto: true
      address: "smtp.office365.com" 
      port: '587'
      domain: "your_domain.com" 
      authentication: :login
      user_name: "email@your_domain.com" 
      password: "password" 

 

No Authentication

Example for an SMTP service provider with no authentication.

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.knology.net"
      port: '25'
      domain: "cybersprocket.com"

 

Using sendmail command

Example for a unix system that uses the /usr/sbin/sendmail command.

production:
  email_delivery:
    delivery_method: :sendmail

Bypass TLS

In case your SMTP server supports TLS, but for some reason you don't have it configured for it (you want to use port 25), the notifications will not work. Dependencies (gems) in the application force TLS to be enabled. To solve this issue, you have to remove the line(s)

enable_starttls_auto: false
verify_openssl_mode: none

and replace with

bypass_tls: true

It will disable TLS and allow to use port 25. You may then remove any other SSL/TLS related lines in the configuration.