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.

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.netapi.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:
- Save the settings.
- Click Test Mail Connection.
- Verify that the connection is successful.
- Send a test email if prompted.
If the test fails, verify:
- Mail driver
- Host
- Port
- Username
- Password
- Encryption
- Firewall restrictions
- Email provider settings
Recommended Configuration
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.