Features

SMTP Configuration

Detailed SMTP settings and connection options for Mailcatcher.

Mailcatcher provides a standard SMTP server for capturing emails. Here are the detailed configuration options.

Connection Settings

SettingValueNotes
Hostmailcatcher.cloud
Port1026Plain SMTP
Port1027Supports STARTTLS
UsernameProject-specificFound in project settings
PasswordProject-specificFound in project settings

Encryption

STARTTLS Support

Mailcatcher supports STARTTLS encryption on port 1027. Your emails are encrypted in transit when STARTTLS is enabled.

Unencrypted Connections

When your application doesn't support encryption, you can connect to port 1026 without encryption. However, we recommend using STARTTLS whenever possible for better security.

Troubleshooting

Connection Refused

If you're getting connection refused errors:

  1. Check that your firewall allows outbound connections on port 1026 and 1027
  2. Verify your credentials are correct
  3. Try port 1026 as an alternative and deactivate encryption

Authentication Failed

If authentication is failing:

  1. Double-check your username and password
  2. Ensure you're using the credentials for the correct project
  3. Try regenerating your password in project settings
  4. Make sure to url-encode any special characters in your password when usign a DSN connection string

Emails Not Appearing

If emails aren't showing up:

  1. Check that you're connected to the correct project
  2. Verify your application's mail configuration
  3. Check for any errors in your application logs