SMTP Email Configuration (Mail)

Simscope uses SMTP to send email notifications to Users.

SMTP Configuration

Simscope can be configured either using basic or authenticated SMTP access.

a. Basic SMTP Configuration (anonymous)

If your SMTP allows anonymous access to send emails (ie Unix emails), here is how to configure:

[email]
enabled = true
# Sender is what shows up as the email sender
sender = "Simscope Triage <no-reply-simscope@COMPANY.com>"
# Set this to the administrator email address, to receive Simscope admin emails
adminaddr = "fred@COMPANY.com"

# Unix SMTP config (change YOUR-SMTP-HOSTNAME)
smtpaddr = "YOUR-SMTP-HOSTNAME:25"

# Note: if you are allowed SMTP relaying via localhost:
# smtpaddr = "localhost:25"

b. Authenticated SMTP Configuration

If your SMTP requires user/password authentication to send emails, here is how to configure:

[email]
enabled = true
# Sender is what shows up as the email sender
sender = "Simscope Triage <no-reply-simscope@COMPANY.com>"
# Set this to the administrator email address, to receive Simscope admin emails
adminaddr = "fred@COMPANY.com"

# Authenticated SMTP
smtpaddr = "smtp.company.com:587"
# NOTE: other common SMTP ports are :25 and :465

smtpaccount = "myuser@company.com"
smtpauth = "mypass"

# Optional: If the SMTP hostname is different than the SMTP address, you can override it
# smtphost = "smtp.company.com"

# Enable STARTTLS (recommended)
starttls = true
# Enable TLS (not recommended)
# tls = true

# Optional: X.509 PEM-encoded CA Certificates (for TLS)
# cacerts = "/usr/local/to/custom/ca-bundle.crt"

CLI testing of emails

If you would like to test your SMTP configuration from the CLI, please contact VerOps to download tmail, a CLI email publish test app.

Testing SMTP emails

After configuring SMTP, you can issue an API token for a user, which will automatically send an email from Simscope:

Check SMTP email

Simscope has an Outbox for debugging email messages.

• Admin → Email Outbox

Check if the API token email is showing up under Sent:

Email debug

Simscope will dump SMTP email delivery failures to the terminal for debugging.

Deleting unsent emails

Simscope will automatically re-try sending unsent emails for a week, and then prune any email if it fails afterward.

If you want to manually delete an unsent email:

• Click Admin → Email Outbox
• Click any unsent email.
• In the top-right corner, click Delete Email