Setup and configuration - Custom SMTP
What this integration does
Mail configuration is a feature of the DockRay panel itself, not something installed on the client's side. It lets you point operational mail for your account - the mail tied to monitoring, not access to the panel itself - at your own mail server. The configuration is split by message purpose (MailPurpose):
- default - the fallback used anywhere a separate configuration is not set,
- alerts - ping, SSL certificate, Google PageSpeed, new errors,
- reports - periodic PDF reports,
- critical - sudden error spikes, because that kind of alert can send a lot of mail at once and is worth keeping on a separate server.
Each purpose can be configured separately or left blank - in which case the default configuration of the same scope applies.
The most important rule
DockRay's own server sends system mail only - password resets, e-mail confirmation, the welcome message. Anything tied to account monitoring - alerts and reports - needs your own SMTP credentials. Until you enter them, that mail does not go out at all - only the notification inside the panel remains. That is a deliberate product decision: DockRay does not send your operational mail through its own infrastructure on your behalf.
What you need from your mail provider
- the SMTP server address (host) and port,
- the connection encryption method,
- a login and password to authenticate with,
- the sender address and name recipients should see.
Configuring it in the DockRay panel
Screen: Settings → Mail configuration.
- Pick the message purpose you want to configure separately.
- Enter the host, port and encryption method.
- Enter the SMTP login and password.
- Set the sender address and name.
- Save and send a test message.
An empty form for a given purpose is not an error - it means 'use the default configuration of this scope'. The system purpose (password reset, verification, welcome mail) is configured only by the Dock team, in the platform scope - a subscriber does not see it, because they never use it.
The test message
The button sends a sample message through the exact configured server, to the signed-in person's address. It is the fastest way to check whether the login details even work, before any real alert tries to take that path.