Koapanel
IT Try it free
All manual sections

DocumentationSystem emails

System emails

The panel can send emails to warn you when something is wrong and to tell you the news of every update. The System emails page is reserved to administrators.

Choosing the sending service

  • Prime Mail: the recommended sending service. You need the service address and the API key (it starts with pm_). The sender is the one configured in your Prime Mail account.
  • SMTP: any mailbox or service offering SMTP. You need server, port, security type, username, password and the sender address. Port 587 with STARTTLS is the usual choice, or 465 with TLS.

API key and password are stored encrypted on the server and are never shown again: leave the field empty to keep the saved one.

Who receives the emails

  • Administrator addresses: they receive the alerts and the news.
  • Users: whoever entered their email on the Account page receives the password change notice and, if the Also tell users about the news option is on, the news of new versions.

Also enter the panel address (for example https://server.example.com:8443): it is used for the buttons in the emails that lead straight to the right page.

Language of the emails

Every email is written in the language of its recipient: the language the user chose on the Account page or, for addresses without an account, the server default language (Account page, administrators). When several recipients speak different languages, the panel sends one message per language.

The alerts

Every alert can be turned on or off:

  • New version installed: one email per version, with the list of what's new.
  • HTTPS certificate expiring: if fewer than 14 days are left and the automatic renewal failed.
  • Backup failed.
  • Disk almost full: above 90%.
  • Password changed: to the user concerned, with date, time and origin address.

So as not to flood your mailbox, the same alert (for the same site) arrives at most once a day, and the panel sends no more than 200 emails per hour.

Testing the configuration

After saving, use Send test email: the result appears right away. At the bottom of the page you find the send log with the last 100 emails, successful or not.

If a send fails because of a temporary problem, the panel retries by itself up to 3 times.