Most hosting services will provide a configured email server. If you are unsure, contact your hosting provider to learn what they are able to offer.
This section describes the requirements for a properly configured email server and discusses some of the configuration options for sending email with OJS, OMP and OPS. If you know what you’re doing, you may prefer to follow the quick setup instructions in our configuration guide.
Your domain must be configured according to the SPF protocol. To comply with this protocol, your domain’s DNS zone must include an appropriate
TXT record. For example, if the application is hosted at
https://my-journals.com, the domain
my-journals.com must have a
TXT record in it’s DNS zone.
Your hosting service should provide instructions on how to add the
To comply with the the DMARC framework, the application must be configured with an envelope sender. The envelope sender is an email address that the server has permission to send as. For example, if the application is hosted at https://my-journals.com, the envelope sender should be an email address
When a user signs up to the application with the email address
email@example.com, your email server does not have permission to send as
firstname.lastname@example.org. The envelope sender acts as the “true” sender, and the email is sent “on behalf of”
To configure the envelope sender, edit the following settings in the application’s
allow_envelope_sender = On default_envelope_sender = <email> force_default_envelope_sender = On force_dmarc_compliant_from = On
The application uses these settings to reconfigure the
REPLY-TO headers in all emails it sends.
Most hosting services will provide the details the application should use to connect to a SMTP server for sending email. If you have those, follow the instructions in the configuration guide.
If not, the server will probably be configured to send email through the
sendmail application. In such cases, set the
default sender to
sendmail in the
[email] default = sendmail
sendmail binary is not at the usual location on the server, you may need to set the
[email] default = sendmail sendmail_path = "<path-to-sendmail> -bs"
In rare cases, neither option is available and you must use
PHPMailer. This mailer is not secure and we strongly discourage its use. However, if you need it, set the
[email] default = phpmailer
Use the following configuration settings to send email through a personal Gmail account:
smtp = On smtp_server = smtp.gmail.com smtp_port = 465 smtp_auth = ssl smtp_username = <email> smtp_password = <password>
You can use a third-party email service, such as MailGun, Amazon SES, or Postmark, to send email if you don’t want to run your own email service. However, this is not officially supported so you may need to write a small amount of custom PHP code.
Under-the-hood, all of our applications use Laravel’s Mail library, which itself uses Symfony’s Mailer. Transports are included for Mailgun, Amazon SES and Postmark, and these services can be used by writing a small plugin. See the example Mailgun plugin.
Other transports can be be found by searching for “symfony mailer transport”. A plugin would need to be written to import these transports and make use of them. If you write a transport for a service, please share it with our community.
Once you have set an
envelope_sender, a new setting will appear under Settings > Workflow > Emails. This allows you to set a custom bounce address for each journal.
Note that this option may require changes to the server’s mail server configuration so that the user the web server runs as (e.g. “www-data”) is trusted by the sendmail program; otherwise an “X-Warning” header will be added to outgoing messages. Consult your mail server’s documentation if outgoing mails include such a header.
For example, Sendmail keeps a list of trusted users in
/etc/mail/trusted-users. Other mail systems use similar files.
The command-line option used to set the envelope sender is -f.
If you are facing problems with emails not being delivered, you should contact whoever runs your email server. This is usually your hosting service provider.
We can not do much to help you troubleshoot problems with your email delivery. That’s because our applications do not actually send the emails themselves. When an application wants to send an email, it sends a request to the email server to send and deliver the email.
Only your email server provider can say whether an email was sent and why.
If you run your own email server, you can ask for help in our community forum. Otherwise, we recommend contacting your web server provider to investigate the following:
REPLY-TOheaders of emails match the SPF and DMARC configuration.
Next, learn about how to improve performance with the job runner.