SMTP
he SMTP Configuration page allows administrators to configure email delivery settings used by OneDB for sending system emails, notifications, and test messages.
SMTP configuration is useful when OneDB needs to send email-based alerts or operational notifications to administrators or system users.
Overview
OneDB can connect to an external SMTP mail server to send emails from the system. Administrators can define the SMTP host, port, encryption type, sender identity, and authentication credentials.
After the configuration is saved, administrators can use the Test SMTP Connection feature to verify that OneDB is able to send email successfully.
SMTP Parameters
The SMTP Parameters section contains the main email server configuration.
| Field | Description |
|---|---|
| SMTP Host | The hostname or IP address of the SMTP server. |
| SMTP Port | The SMTP server port used for email delivery. |
| Encryption | The encryption method used when connecting to the SMTP server, such as SSL or TLS. |
| SMTP Username | The username used to authenticate with the SMTP server. |
| SMTP Password | The password or application password used for SMTP authentication. |
| Sender Email | The email address that will appear as the sender of OneDB emails. |
| Sender Name | The display name that will appear as the email sender name. |
After completing the required fields, click Save Configuration to store the SMTP settings.
Test SMTP Connection
The Test SMTP Connection section allows administrators to send a test email using the saved SMTP configuration.
This helps verify that:
- The SMTP host and port are reachable.
- The username and password are valid.
- The selected encryption method is correct.
- OneDB can successfully send emails through the configured SMTP server.
| Field | Description |
|---|---|
| Recipient Email | The destination email address for the test message. |
| Subject | The subject of the test email. |
| Message | The body content of the test email. |
Click Send Test Email to send a test message.
If the test email is received successfully, the SMTP configuration is ready to use.
Common SMTP Ports
The following ports are commonly used by SMTP providers:
| Port | Common Usage |
|---|---|
| 25 | Standard SMTP port, often restricted by hosting providers. |
| 465 | SMTP over SSL. |
| 587 | SMTP with STARTTLS, commonly used for authenticated email sending. |
The required port and encryption method may vary depending on the email provider.
Best Practices
Use a dedicated email account for OneDB system notifications instead of a personal mailbox.
For production environments, it is recommended to use secure SMTP encryption such as SSL or TLS.
When using providers such as Gmail, Microsoft 365, or other managed email services, an application password or SMTP-specific credential may be required.
After changing SMTP settings, always send a test email to confirm that the configuration is working correctly.
Troubleshooting
If the test email fails, verify the following:
| Issue | Recommended Check |
|---|---|
| Email is not sent | Check SMTP host, port, encryption, username, and password. |
| Authentication failed | Verify the SMTP username and password. Some providers require an app password. |
| Connection timeout | Check firewall rules, network access, and whether the SMTP port is allowed. |
| Email goes to spam | Verify sender email, sender name, SPF, DKIM, and mail server reputation. |
| SSL or TLS error | Confirm that the selected encryption method matches the SMTP port. |
Notes
SMTP configuration is used by OneDB for email delivery features. Some notification features may depend on SMTP being configured correctly before emails can be sent.
