Configuring SMTP

To send email notifications, you need to configure an SMTP provider. Flux supports any standard SMTP server (Gmail, Outlook, SendGrid, AWS SES, Mailgun, etc.).

Step 1: Gather Credentials

You will need the following details from your email provider:

• Host: e.g., smtp.gmail.com or email-smtp.us-east-1.amazonaws.com.
• Port: Usually 587 (STARTTLS) or 465 (SSL/TLS).
• Username: Often your email address or an API Key ID.
• Password: Your email password or API Secret Key.
  • Note: If using Gmail, you must generate an App Password.

Step 2: Configure Flux

1. SSH into your Flux instance:
2. Select SMTP -> n (Create New).
3. Config Name: Give it a unique ID (e.g., main-mailer).
4. Host: Enter the SMTP host.
5. Port: Enter the port number.
6. Username & Password: Enter your credentials.
7. From Address: The email address that messages will appear to come from.
   • Crucial: Many providers (like SES or Gmail) strictly enforce that this address matches the authenticated user.
8. Select Save.

You can always manage the SMTP that you already created by pressing enter on the table or x to delete them

Step 3: Attach to Form

1. Go back to the Dashboard.
2. Select Manage Forms.
3. Select the form you want to connect.
4. Select Manage Notifications.
5. Add a new notification with Method: SMTP and select your new provider (main-mailer).
6. Set the Target to the email address where you want to receive the submissions.

Security Note

Your SMTP password is encrypted immediately upon saving using the Flux Master Key (AES-GCM). It is never stored in plain text on the disk.