Docbox can send email notifications to users when a print job is quarantined, cancelled, or deleted. This means users are alerted to issues without needing to log in to the dashboard to check. Notifications are sent to the user who submitted the job.
To send notifications, Docbox requires access to an SMTP relay. The sender address (for example, docbox@yourdomain.com) can be customised to meet your organisation's standards.
You can access Email Settings via Control Panel > System Settings > Email Settings.
Only Administrators can access Email Settings.
Click Save Configuration to apply any changes. Click Reset Changes to discard unsaved edits and restore the form to the last saved values.
Sending a Test Message
Click Send Test Message to confirm your email configuration is working, without waiting for a real print job to trigger a notification.
The test uses your currently saved settings, not any unsaved changes in the form. If you've just changed a setting, click Save Configuration first, otherwise the test will use the previous configuration.
A dialogue opens with the recipient field pre-filled with your own email address. You can change this to test delivery to a different mailbox, then click Send Test Message to send it. Click Cancel to close the dialogue without sending.
Once sent, a confirmation shows the address the test was sent to.
Basic Settings
| Field | Description |
|---|---|
| Email Enabled | When ticked, Docbox will send email notifications. When unticked, no emails are sent regardless of other settings. |
| Send Email From Address | The email address that will appear in the From field of notifications sent by Docbox. |
| Server Name / IP | The hostname or IP address of your SMTP server. |
| Port Number | The port your SMTP server listens on. Defaults to 25. |
| Timeout (seconds) | The number of seconds Docbox will wait for a response from the SMTP server before timing out. |
Server Credentials
If your SMTP server requires authentication, enter the credentials here. Leave blank if your server does not require authentication.
| Field | Description |
|---|---|
| Username | The username Docbox uses to authenticate with the SMTP server. |
| Password | The password for the SMTP account. Use the Show button to toggle visibility. |
TLS Configuration
| Field | Description |
|---|---|
| SMTP Security Mode | The encryption mode used when connecting to the SMTP server. Select the strongest mode your server supports. Options are None, STARTTLS (opportunistic), STARTTLS (required), and SSL/TLS. |
| Public Certificate | If your SMTP server uses a certificate issued by an internal Certificate Authority (CA), paste the CA's public certificate here in PEM format (beginning with -----BEGIN CERTIFICATE-----). Once a valid certificate is entered, Docbox displays the certificate details to help you confirm you have the correct one. |
Advanced Settings
The Advanced Settings panel is collapsed by default. Click the + icon to expand it.
The settings in this section may reduce email security and should only be changed if required.
| Field | Description |
|---|---|
| Check Server Identity? | When ticked, Docbox verifies that the server identity matches the certificate. This should remain enabled to protect against man-in-the-middle attacks. |
| Always Trust Server? | When ticked, Docbox trusts the server certificate without verification. This option should only be used when TLS is enabled but a trusted certificate cannot be provided. It is not recommended as it exposes email traffic to man-in-the-middle attacks. |
| Enable Debug Logging? | When ticked, Docbox captures detailed email diagnostic data in the server logs. This should only be enabled when investigating email delivery issues with CFH support and should be disabled at all other times. |