Skip to content
LogScale Self-Hosted Deployment
Content was updated: Apr 28, 2025
This is an archived version of the documentation downloaded from LogScale Documentation Archives. Up to date documentation, and documentation for later versions, is available on LogScale Documentation

### SMTP Server Configuration

The documentation provides comprehensive instructions for configuring SMTP server settings in LogScale, including essential parameters like host, port, sender address, authentication credentials, and TLS options. While Gmail integration is discussed, it's notably mentioned that starting January 2025, Gmail will deprecate non-OAuth SMTP authentication methods, impacting LogScale's ability to use Gmail for functions like alert notifications.

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.

### Important

Update: starting from January 2025, Gmail has deprecated non-OAuth SMTP authentication methods and no longer allows customers to use "Less Secure" access for SMTP. See Gmail notice for more information. This change impacts LogScale's SMTP server capabilities with Gmail, like for example the ability to receive alert notifications. Therefore, the SMTP Server configuration guidelines for Gmail outlined below no longer apply at this point, until a workaround solution is found.

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.

#### Enter search term