Certain functionalities such as
password reset and
inviting new users require email messaging. So, unless you setup SMTP, these features won’t work. We highly recommend using an Email Service Provider (ESP), like Mailgun or SendGrid, for maximum reliability and deliverability. Below we provide a step-by-step guide on how to configure Mailgun, but any other provider will do the job.
SMTP configurationSection titled SMTP configuration
To enable SMTP,
openreplay -e and update the below env variables in
|emailHost||SMTP hostname (i.e. smtp.mailgun.org)|
|emailUseTls||true||For using TLS when connecting to the SMTP host|
|emailUseSsl||false||For using SSL when connecting to the SMTP host|
|emailSslKey||Path to your SSL key (if applicable)|
|emailSslCert||Path to your SSL certificate (if applicable)|
|emailFromemail@example.com||The sender email|
Then, save and quit using
:wq for the changes to take effect. You can then test the setup by inviting yourself (using another email) as a new team member (in ‘Preferences’ > ‘Users’).
MailgunSection titled Mailgun
- Go to ‘Sending’ > ‘Domains’ then click ‘Add New Domain’
- Enter your subdomain (i.e. m.mycompany.com) in ‘Domain name’ and ensure ‘Create DKIM Authority’ is checked, with preferably a 2048 key length
- Go to your DNS provider (specific instructions are provided by Mailgun) and add all displayed records
- Once all records added, click ‘Verify DNS Settings’
- Now go to ‘Sending’ > ‘Domains settings’ > ‘SMTP credentials’ and click ‘Add new SMTP user’. Enter ‘Login’ (i.e. openreplay) then click ‘Create SMTP credentials’. A popup should appear, hit ‘Copy’ to copy the generated password.
- Use the displayed SMTP settings and credentials to configure SMTP in OpenReplay.
openreplay -eand update the below env variables in
emailHost: 'smtp.eu.mailgun.org' # from SMTP settings section emailPort: '587' emailUser: 'firstname.lastname@example.org' # from SMTP credentials section emailPassword: 'password' # the one copied when you created SMTP credentials emailUseTls: 'true' emailUseSsl: 'false' emailSslKey: '' emailSslCert: '' emailFrom: 'email@example.com' # sender email, use your domain'
- Save and quit using
:wqfor the changes to take effect.
- You can test the setup by inviting yourself (using another email) as a new team member (in ‘Preferences’ > ‘Users’).
Have questions?Section titled Have questions?
If you have any questions about this process, feel free to reach out to us on our Slack channel.