Projects - Mailcatcher Docs

Projects in Mailcatcher help you organize emails by application, environment, or team. Each project has its own SMTP credentials and settings.

Creating a Project

Navigate to your dashboard
Click the New Project button
Enter a descriptive name
Copy your SMTP credentials

Project Settings

SMTP Credentials

Each project has unique SMTP credentials:

Username: Automatically generated
Password: Shown once at creation (can be regenerated)
DSN: Connection string for frameworks that support it

You can regenerate your SMTP password at any time from the project settings. Remember to update your application configuration after regenerating.

Email Retention

Configure how long emails are stored:

Plan	Retention
Free	10 emails per project
Professional	Unlimited emails, 2 GB storage

Private Asset Domains

For security, Mailcatcher doesn't load external images by default. You can whitelist trusted domains in your project settings to automatically load images from those sources.

Managing Projects

Renaming a Project

Go to Project Settings
Update the project name
Click Save

Deleting a Project

Deleting a project permanently removes all associated emails and settings. This action cannot be undone.

To delete a project:

Go to Project Settings
Scroll to the Danger Zone
Click Delete Project
Confirm the deletion