Skip to content

Test Emails (Local SMTP)

Fynx includes a built-in local SMTP receiver — similar to Mailtrap or MailHog —
so you can test outgoing emails from your app without sending them to real inboxes.

This feature lets developers preview and debug email content directly within Fynx.

🧩 How It Works

  1. Fynx runs a lightweight SMTP server in the background.
  2. Your app sends emails to that SMTP address instead of a real one.
  3. Emails appear instantly inside the Test Emails panel in Fynx.

⚙️ SMTP Configuration

Update your app’s mail settings to point to the Fynx SMTP server.

Example (Laravel)

In your .env file:

env
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=

WARNING

Make sure your MAIL_ENCRYPTION, MAIL_PASSWORD and MAIL_USERNAME are empty.

Then send a test email:

bash
php artisan tinker
>>> Mail::raw('Test message from Fynx', fn($m) => $m->to('test@example.com')->subject('Hello!'));

Your message will appear instantly in Fynx → Test Emails.

💻 Supported Frameworks

Any framework or language that supports SMTP can use Fynx’s local mail receiver:

FrameworkTypical PortExample
Laravel2525MAIL_HOST=127.0.0.1
Node.js (Nodemailer)2525host: '127.0.0.1', port: 2525
Python (Django)2525EMAIL_HOST = 'localhost'
PHP (native)2525ini_set('SMTP', 'localhost');

✉️ Viewing Emails

Open the Test Emails tab in Fynx to:

  • Preview HTML and plain text versions
  • View headers and raw source
  • Reopen or clear inbox
  • Copy test addresses

Emails are stored temporarily and are never sent externally.

🧹 Clearing Inbox

To remove all stored messages, click Clear Inbox at the top of the Test Emails view.

⚠️ Notes

  • The SMTP server only accepts local connections (127.0.0.1).
  • It runs automatically when the Test Emails feature is enabled.
  • No internet access is required.
  • Emails are deleted when Fynx closes (for privacy and performance).

✅ Use this feature to safely test password resets, registration emails, and notifications — all without leaving your local environment.

Released under the MIT License.