SMTP Mailer Guide

Configure a mailer within Enterprise Search to send user invitations and password resets.

The Mailer is present within config/enterprise-search.yml.

Mailer, Local Mail Service Example

If you're using something like Postfix, a mailer configuration might look like this:

email.account:
  enabled: true
  smtp:
    auth: plain # Can be plain, login, or CRAM-MD5.
    starttls.enable: false # Whether emails are sent encapsulated in TLS, or not.
    host: 127.0.0.1
    port: 25
    user: mail@example.com
    password: secure-pass-phrase
  email_defaults:
    from: noreply@example.com # The 'from' address is the address from which emails are sent.

Mailer, GMail Example

Gmail makes for a handy and easy to setup SMTP server.

There are multiple options. You can use a G Suite organization or a personal account.

Read the Google documentation to get it setup, then plug the values in as such:

email.account:
  enabled: true
  smtp:
    auth: plain
    starttls.enable: true
    host: smtp.gmail.com
    port: 587
    user: example@gmail.com
    password: secure-pass-phrase
  email_defaults:
    from: noreply@gmail.com

Mailer, Outlook Example

Outlook can send mail.

Read the Microsoft Office documentation to learn more.

Plugin your values once you receive them:

email.account:
  enabled: true
  smtp:
    auth: login
    starttls.enable: true
    host: https://smtp-mail.outlook.com
    port: 587
    user: example@outlook.com
    password: secure-pass-phrase
  email_defaults:
    from: noreply@outlook.com

---

Enjoying the beta? Something broken? Lost? Please send us your feedback or visit the Enterprise Search community.