Skip to content

Email setup

Aisman uses a centralized email service to send transactional emails such as registration confirmations, password resets, and email-change verifications.

The email settings live under the Email key in appsettings.json:

"Email": {
"UseEmail": "SMTP",
"TestMode": {
"Active": true,
"Email": "your-test@example.com"
},
"SMTP": {
"Host": "smtp.your-provider.com",
"Port": 587,
"Username": "your-username",
"Password": "your-password",
"FromAddress": "noreply@yourdomain.com",
"FromName": "Aisman",
"UseSsl": true
}
}
SettingDescription
UseEmailWhich email service to use. Currently only SMTP is supported.
TestMode.ActiveWhen true, all outgoing emails are redirected to TestMode.Email regardless of the original recipient. Useful for development and testing.
TestMode.EmailThe email address that receives all emails when test mode is active.
SMTP.HostYour SMTP server hostname.
SMTP.PortSMTP port (typically 587 for TLS or 465 for SSL).
SMTP.UsernameSMTP authentication username.
SMTP.PasswordSMTP authentication password.
SMTP.FromAddressThe “From” address on outgoing emails.
SMTP.FromNameThe display name for the “From” address.
SMTP.UseSslWhether to use SSL/TLS when connecting to the SMTP server.

The following account pages send real emails through the centralized service:

  • Register: Sends a confirmation email after account creation.
  • Check email: Resends the confirmation email on request.
  • Forgot password: Sends a password reset email with a styled reset link.
  • Settings (email change): Sends verification emails to both the old and new addresses.

The Email configuration structure is designed to support additional services beyond SMTP. To add a new service (for example Mailgun), add a new key alongside SMTP and update UseEmail to point to it.