SMTP Server Configuration

LogScale only supports the LOGIN authentication method for SMTP or using a local SMTP server without authentication.

If you're using Gmail, you'll have to enable "Less Secure App Access". Gmail defines "Less Secure" as not OAuth, which LogScale does not support for SMTP. We feel that using a fixed password, rather than per-app OAuth tokens, is less secure.

To configure SMTP-based email, you will need to set the following parameters:

  • SMTP_HOST

    This option is used to set the hostname or IP address of the server named with SERVER.

  • SMTP_PORT

    This is the port number LogScale is to send SMTP messages. This is usually set to a value of 587, 465 or 25, depending on how your SMTP server is set

  • SMTP_SENDER_ADDRESS

    This is the sender email address that LogScale will use when sending emails — this is the from address, not the to address. Due to DMARC policies on our domain, don't use a crowdstrike.com sender email address.

  • SMTP_USERNAME

    This setting is optional. It's for the user name to use when authenticating with the SMTP server. If not specified, communication will be attempted without authentication. If this is specified, though, you will also have to provide a value for the SMTP_PASSWORD option.

  • SMTP_PASSWORD

    This setting is also optional, but required if giving the user name above. This variable is used to set the password to use when authenticating with the SMTP server. If not specified, communication will be attempted without authentication. If this is option specified, though, you'll also have to provide SMTP_PASSWORD.

  • SMTP_USE_STARTTLS

    Use this option to enable the opportunistic TLS communication protocol. If it's set to true, LogScale will use StartTLS for the connection to the SMTP server. The default value is false, which makes it an optional setting.

It's very common to use SMTP with Gmail and other email services. To do this, you'll need to create an app-password that LogScale can use to send emails through the email server. For Gmail, go to the Google App Password page to generate the app specific password.

Below is an example of how the SMTP section of the configuration file may look if you're using Gmail or a similar email service:

ini
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SENDER_ADDRESS=my-email@gmail.com
SMTP_USERNAME=my-email@gmail.com
SMTP_PASSWORD=app-password
SMTP_USE_STARTTLS=true

For more information on each of these environment variables, see the Configuration reference page.