How to Configure Email Notifications On-Premises

Introduction

To enable Easy8 to send email notifications about tasks, updates, and other system events, you must connect it to an SMTP server. This guide explains how to configure outgoing email settings on your own server using the configuration.yml file.

Target Audience

Administrator

Prerequisites

Before you begin, ensure you have:

Access to your Easy8 server
Permissions to edit the configuration.yml file located at:
[redmine root]/config/configuration.yml
SMTP credentials or access to a working mail server

Restart the application server after saving changes for them to take effect.

How to Configure Email Notifications

Step 1: Edit the Configuration File

Open configuration.yml and locate the production: section. You can define different settings for development: as well, but only the production: section affects your live environment.

Example 1: Simple Login Authentication (Default)

production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "smtp.example.net"
      port: '25'
      domain: "example.net"
      authentication: :login
      user_name: "easyredmine@example.net"
      password: "easyredmine"

Example 2: Gmail / Google Workspace (TLS Required)

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"

Example 3: Office 365 / Exchange Online

If sending from a shared mailbox, ensure the user has "Send As" permission.

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"

Example 4: SMTP with No Authentication

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

Example 5: Sendmail Command (Unix Systems)

production:
  email_delivery:
    delivery_method: :sendmail

Step 2: Disable TLS (Bypass)

If your SMTP supports TLS but it is not configured:

Do NOT use these lines:

enable_starttls_auto: false
verify_openssl_mode: none

Instead, use this:

bypass_tls: true

Also remove any other SSL/TLS settings to avoid conflicts.

Step 3: Restart the Application

After saving your configuration, restart the application server to apply the changes:

sudo systemctl restart puma

Step 4: Test Email Notifications

In Easy8, go to:

Administration → Settings → Email notifications → Send a test email

Verify that emails are being sent correctly.

Conclusion

Configuring outgoing email in Easy8 requires editing the configuration.yml file and restarting the application. Choose the correct SMTP setup based on your provider and environment. Always test the configuration after restarting to ensure emails are sent properly.