Skip to content

Email ​

Qorekit sends email for invitations, forgotten passwords and notifications. Until email is set up, those messages reach nobody: Administration › Email says so at the top. Only administrators see this page.

Choosing how to send ​

Send email through offers:

  • SMTP server: the most reliable. Your hosting provider or email service gives you its server, port and an account to send with. Most use port 587 with STARTTLS; some use port 465 with SSL/TLS.
  • The server's sendmail: the mail program of the server Qorekit runs on. Many hosts allow it and it needs no account, but its messages more often end up in spam folders.

The sender address is what people see the email come from. Use an address at your own domain that the SMTP account may send from; many servers refuse other addresses, and receivers trust them less. Left empty, Qorekit uses the address in the server's environment file, or no-reply@ your domain. The sender name is your installation's name unless you give another.

The password is stored encrypted with the application key and never shown again. Leave the field empty to keep it.

If the server's environment file already sets up email (MAIL_MAILER), Qorekit uses it until you save settings here.

Sending a test email ​

Send test email sends a message at once with the settings on the page, saved or not, to you or the address you give. If it cannot be sent, the page shows the mail server's answer, such as a wrong password or a refused connection. Check that the message arrived, and look in the spam folder too.

How email goes out ​

Messages wait in a queue in the database. The one someone is waiting for, such as a password link, is sent right after they ask for it. Anything that could not be sent is tried again a few times by scheduled work, so a short outage of the mail server loses nothing.

The page lists messages still waiting and the last ones that failed after every attempt, with the reason. Many waiting messages usually mean that scheduled work does not run: see the System page.