SMTP Configuration

Menu path: Admin -> Settings -> SMTP Configuration

Route: /admin/settings/smtp

Use this page to configure email delivery for the application.

Why this page is important

If email is not working, many other features will also fail or become confusing for users.

This includes:

• admin account delivery
• password reset
• login alerts
• exchange notifications
• reserve request notifications
• broadcast email campaigns

SMTP field guide

Field	What it means	What to enter
Mail Driver	Delivery method	Use SMTP in most cases. Use Sendmail only if your server is already configured for it
Encryption / Scheme	Mail connection security	Use TLS on port 587 for most providers. Use SSL on port 465 only if required
Mail Host	SMTP server host name	Example: smtp.gmail.com, smtp.office365.com, or your provider host
Mail Port	SMTP server port	Usually 587 for TLS or 465 for SSL
Mail Username	SMTP login name	Usually the full email address
Mail Password	SMTP login password	Use the correct SMTP password or app password
Mail From Address	Sender email shown to users	Use a real email address from the same mail account or domain
Mail From Name	Sender name shown in mail clients	Use your website or company name

SMTP test console

This page also includes a test tool:

• Recipient Email: Address that will receive the test mail.
• Subject (Optional): Custom subject for the test mail.

After the test, the page shows:

• Connection result
• Host and port used
• Error type
• Short recommendation if the test fails

Safe starting values

• Mail Driver: SMTP
• Encryption / Scheme: TLS
• Mail Port: 587
• Mail Username: full mailbox address
• Mail From Address: same mailbox or approved sender address

Important note

This page updates environment mail values from the admin panel. After save, the queue is restarted automatically.

Common mistakes

• using the wrong port for the selected encryption type
• using a normal mailbox password when the provider requires an app password
• using Sendmail when the server is not configured for sendmail
• saving the settings without running the test
• using a Mail From Address that the provider does not allow

If the SMTP test fails

Check these points:

• host and port are correct
• encryption matches the provider requirement
• username and password are correct
• your server firewall allows outbound SMTP
• your provider requires an app password or special SMTP permission

Best practice

• run the SMTP test before using email-dependent features
• test with a real mailbox you can check immediately
• configure this page before Admin Management or Broadcast Campaigns

Related pages

• Notification Settings
• Admin Management
• Broadcast Campaigns