> For the complete documentation index, see [llms.txt](https://archivedocs.stackstate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://archivedocs.stackstate.com/5.1/configure/topology/configure-email-event-notifications.md).

# Enable email event notifications

## Overview

StackState can send an event notification by email whenever the health state of an entity or view changes. To enable email event notifications, the StackState configuration must include details of the SMTP server to use.

## Configure an SMTP server to use for email event notifications

{% tabs %}
{% tab title="Kubernetes" %}

1. Update the StackState configuration in `values.yaml` to include SMTP server details:

   ```
    stackstate:
      components:
        viewHealth:
          config: |
            stackstate{
              email {
                properties {
                  "mail.smtp.auth" = "true"   # "true" when user/pass provided   
                  "mail.smtp.starttls.enable" = "false"   # use "true" for TLS
                }
                sender = "<EMAIL_SENDER_ADDRESS>"
                server {
                  protocol = "smtp"
                  host =  "<SMTP_SERVER_HOST>"
                  port = 25
                  username = "XXX"      # optional
                  password = "XXX"      # optional
                }
              }
            }
   ```
2. Restart StackState to apply the configuration changes.
3. You can [manage the event handlers configured for a view](/5.1/use/events/manage-event-handlers.md) in the StackState UI right panel **View summary** tab under **Event handlers**.
   {% endtab %}

{% tab title="Linux" %}

1. Update the StackState configuration file `application_stackstate.conf` to include SMTP server details:

   ```
    stackstate{
      ...

      email {
        properties {
          "mail.smtp.auth" = "true"   # "true" when user/pass provided   
          "mail.smtp.starttls.enable" = "false"   # use "true" for TLS
        }
        sender = "<EMAIL_SENDER_ADDRESS>"
        server {
          protocol = "smtp"
          host =  "<SMTP_SERVER_HOST>"
          port = 25
          username = "XXX"      # optional
          password = "XXX"      # optional
        }
      }

       ...
    }
   ```
2. Restart StackState to apply the configuration changes.
3. You can [manage the event handlers configured for a view](/5.1/use/events/manage-event-handlers.md) in the StackState UI right panel **View summary** tab under **Event handlers**.
   {% endtab %}
   {% endtabs %}

## See also

* [Manage Event Handlers](/5.1/use/events/manage-event-handlers.md)
* [Event handler functions](/5.1/develop/developer-guides/custom-functions/event-handler-functions.md)