Email Settings Administration¶
Overview¶
KrakenHashes supports email functionality through multiple providers, currently SendGrid and Mailgun. This document covers the configuration and management of email settings through the admin interface.
Provider Configuration¶
Admin Settings Email Configuration page showing Mailgun provider setup with API Key, Domain, From Name, From Email, and Monthly Limit fields
SendGrid¶
To configure SendGrid as your email provider:
- Select "SendGrid" from the Provider dropdown
- Configure the following fields:
- API Key: Your SendGrid API key with email sending permissions
- From Email: The verified sender email address
- From Name: Display name for the sender (defaults to "KrakenHashes")
- Monthly Limit: (Optional) Set a monthly email sending limit
Mailgun¶
To configure Mailgun as your email provider:
- Select "Mailgun" from the Provider dropdown
- Configure the following fields:
- API Key: Your Mailgun API key
- Domain: Your verified Mailgun domain
- From Email: The verified sender email address
- From Name: Display name for the sender (defaults to "KrakenHashes")
- Monthly Limit: (Optional) Set a monthly email sending limit
Monthly Limit¶
The monthly limit field is optional: - Leave empty for unlimited emails - Set a numeric value to limit monthly email sending - Helps prevent unexpected costs from email service providers
Testing and Saving Configuration¶
Configuration Options¶
When saving email provider settings, you have three options:
- Cancel: Discard changes and return to previous settings
- Save Configuration: Save settings without testing
- Test and Save: Test the configuration before saving
Testing Process¶
When using "Test and Save":
- Enter a test email address
- System sends a test email to verify configuration
- If successful:
- Configuration is saved
- Confirmation message displayed
- If failed:
- Error message displayed
- Configuration not saved
- Troubleshooting information provided
Email Templates¶
Email templates are managed separately from provider configuration. For detailed information about email templates and available variables, see Email Templates Documentation.
Best Practices¶
- Provider Selection
- Choose based on your volume needs
- Consider provider-specific features
-
Review pricing structures
-
Configuration Testing
- Always test configuration before deployment
- Verify emails are received
-
Check spam folder during testing
-
Monthly Limits
- Set based on expected usage
- Include buffer for unexpected spikes
-
Monitor usage through provider dashboards
-
Security Considerations
- Store API keys securely
- Use dedicated sending domains
- Regularly rotate API keys
- Monitor for unusual activity
Troubleshooting¶
Common Issues¶
- Emails Not Sending
- Verify API key permissions
- Check monthly limit hasn't been reached
- Confirm sender email is verified
-
Review provider dashboard for blocks
-
Test Emails Failing
- Verify API key is correct
- Check domain configuration (Mailgun)
- Ensure test email address is valid
-
Review error messages in admin interface
-
Template Issues
- Verify template syntax
- Check variable names match expected format
- Preview templates before saving
- Test with various data scenarios