Local Mail Testing
Test email delivery locally without spamming real inboxes.
Kythia Workspace provides a built-in local SMTP server and web interface for testing email delivery in your development environment. This is powered by Mailpit, a fast and modern email testing tool.
Overview
When developing web applications, you often need to test email functionality (e.g., password resets, welcome emails, order confirmations). Sending these to real email addresses during development is risky and slow.
Kythia's Mail service solves this by capturing all outgoing emails and displaying them in a beautiful, built-in web interface right inside the workspace.
How to use Local Mail
Start the Service
Navigate to the Mail tab in the sidebar and click Start. If Mailpit isn't installed yet, Kythia will download and set it up automatically. (SMTP runs on port 1025, Web UI on 8025).
Configure Your App
Update your application's .env to route emails to the local SMTP server. (See configuration example below).
View the Inbox
All outgoing emails from your local apps are intercepted. Read, inspect HTML/Text, view raw headers, and delete emails directly inside Kythia's built-in Mail UI!
SMTP Configuration
Use the following credentials in your .env or configuration file:
MAIL_MAILER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"This configuration works universally for Laravel, Symfony, WordPress (via SMTP plugins), Node.js (Nodemailer), and more.
Features
- Built-in Inbox: Read all intercepted emails directly inside the Kythia UI. No need to open a separate browser tab.
- HTML & Plain Text: Toggle between HTML rendering and plain-text fallbacks.
- Header Inspection: View raw email headers to debug routing or anti-spam configurations.
- Fast Deletion: Clear your entire inbox with a single click during heavy testing sessions.