Why are my emails not being sent?
This can come from a variety of reasons, here are the most common ones.
Reason 1: Configuration issues
There may be an issue with some of the SMTP configuration items, such as credentials, or the hostname, or the port for the selected protocol.
By default passbolt is quite discrete on why a given configuration is not working. You can use the following command to send a test email and get more debug information:
$ ./bin/cake passbolt send_test_email --recipient=[email protected]
If this fails you should double check what is the recommended configuration in your email provider documentation. You can also ask on the community forum in case another user have a working configuration for the same provider.
Reason 2: Email notifications are disabled in the config
Another reason could be because email notifications are disabled in you configuration. You can review such settings in the administration panel, when you are logged in as an administrator in passbolt.
Depending on the configuration method you have used to setup, you may need to check for configuration
config/passbolt.php or with environment variables you are loading (if you use docker containers for example).
Reason 3: The cron job to send email is missing
Passbolt uses a system of email queue to send email notifications. In practice this means there is a dedicated job that runs to go through the queue and send emails at the interval of your choice.
So if you manage to send the test email but are not receiving notifications (such as registration emails), one of the reason may be that the cron job required to send the emails is missing. Depending on the method you used to install, it may have not be set, or failed to set.
In order to find out you should check if you have the following cron for the web server user
www-data on Debian/Ubuntu,
nginx on Centos), running where you passbolt was installed
/var/www/passbolt by default).
$ crontab -u www-data -e * * * * * /var/www/passbolt/bin/cake EmailQueue.sender >> /var/log/passbolt.log
If the cron is present, you should check if there are more data in the
/var/log/passbolt.log log file,
it may give you more information about the issue.
Reason 4: The webserver user is not allowed to run cron jobs
On some system, like RHEL or Centos, the
nginx user may not have the right to run the cron job to send emails,
because of your PAM configuration. In this case you may want to add
nginx to the PAM config to have
Reason 5: There is an issue with the database schema related to the email queue
If after an update you are getting error messages such as:
Exception: SQLSTATE[42S22]: Column not found: 1054 Unknown column ‘EmailQueue.to’ in ‘field list’ ...
It is possible that the wrong version of the data model is stored in the cache. This can happen if the cache is not cleared after an install or an update. You can try clearing out the cache to solve this.
./bin/cake cache clear_all
Other frequently asked questions in the same category
- How to install passbolt server
- How to make passbolt backups
- How can I update my passbolt server?
- What are the minimum server requirements?
- Does passbolt provide hosting?
- Where can I get help for installation issues?
- Why do I see an unsafe mode banner in the footer?
- Why are my emails not being sent?
- Why should I install haveged on virtual environments?
- How to update my subscription key
- How to increase auto logout time?
- Why am I getting ldap synchronization issues?