Docs / General / Mail Configuration
Article

Mail Configuration

Configure the email service used by InstiKit to send system emails and notifications.

General 3 min read

The Mail Configuration page allows you to configure the email service used by InstiKit.

Email is used throughout the application to send password reset links, notifications, OTPs, receipts, reminders, and other system-generated emails.

Important

Mail configuration is only required if your organization intends to send emails from InstiKit.

After completing the configuration, use the Test Mail Connection button to verify that your settings are correct before using the system in production.

InstiKit Mail Config


Supported Mail Drivers

InstiKit currently supports the following mail drivers:

  • Log
  • SMTP
  • Sendmail
  • Mailgun

Choose the driver that best matches your hosting environment or email service provider.


Log Driver

The Log driver is the default mail driver after installation.

Instead of sending emails, every outgoing email is written to the Laravel log file.

This driver is useful during:

  • Local development
  • Testing
  • Troubleshooting email templates

Emails can be viewed in:

storage/logs/laravel.log

Note

The Log driver does not send actual emails.


SMTP Driver

SMTP is the most commonly used mail driver.

It allows InstiKit to send emails using any SMTP-compatible email provider.

Popular providers include:

  • Gmail
  • Microsoft Outlook
  • Zoho Mail
  • Amazon SES
  • Mailtrap
  • SendGrid
  • Brevo (Sendinblue)
  • Any custom SMTP server

Host

Enter the SMTP server hostname.

Example

smtp.gmail.com

Port

Enter the SMTP server port.

Common values include:

  • 465 (SSL)
  • 587 (TLS)
  • 25 (Unencrypted or server-specific)

Always follow the recommendations provided by your email service provider.


Username

Enter the SMTP username.

This is usually your email address.


Password

Enter the password or application password for your SMTP account.

Keep this value confidential.


Encryption

Select the encryption method used by your SMTP server.

Supported options include:

  • SSL
  • TLS

Choose the option recommended by your email provider.


Sendmail Driver

The Sendmail driver uses your server's local mail service to send emails.

This option is commonly available on VPS or dedicated servers where Sendmail or a compatible mail transfer agent (MTA) has already been installed.

No additional SMTP credentials are required.


Mailgun Driver

Mailgun is a cloud-based email delivery service designed for reliable transactional emails.

To use Mailgun, create an account and configure a sending domain.


Domain

Enter the Mailgun sending domain.

Example

mg.example.com

Secret

Enter the Mailgun API Secret.

Keep this value confidential.


Endpoint

Specify the Mailgun API endpoint.

Examples include:

  • api.mailgun.net
  • api.eu.mailgun.net

Choose the endpoint that matches your Mailgun region.


Sender Information

These settings determine the sender information displayed in outgoing emails.

From Name

Enter the sender name that recipients will see.

Examples:

  • ABC Public School
  • Green Valley College
  • Sunrise International School

From Address

Enter the email address used as the sender.

Examples:

[email protected]
[email protected]

This email address should belong to the configured mail service.


Testing Mail Configuration

After completing the configuration:

  1. Save the settings.
  2. Click Test Mail Connection.
  3. Verify that the connection is successful.
  4. Send a test email if prompted.

If the test fails, verify:

  • Mail driver
  • Host
  • Port
  • Username
  • Password
  • Encryption
  • Firewall restrictions
  • Email provider settings

For most organizations:

Mail Driver Recommended Use
Log Local development and testing
SMTP Most schools and organizations
Sendmail Self-managed Linux servers
Mailgun High-volume production environments

Saving Changes

After updating the mail configuration, click Save to apply the changes.

We strongly recommend testing the mail connection immediately after saving to ensure emails can be delivered successfully.