> 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/proxy-for-event-handlers.md).

# Use a proxy for event handlers

## Overview

StackState can be configured to use a proxy for event handlers. When client proxy settings are configured for `http` or `https` in the StackState `application_stackstate.conf` file, these will be used by all event handlers. No further changes are required in the event handler function script.

## Configure a proxy for event handlers

To use a proxy for event handlers, proxy details must be added to the `akka` section of the StackState `application_stackstate.conf` file.

1. Edit the file `application_stackstate.conf`.
2. Add details of the proxy `host` and `port` to the `akka` section at the bottom of the file. Note that the specified proxy will be used for both HTTP and HTTPS requests.

   ```
   stackstate {
     ...
   }

   akka {
     http {
       ...
       client {
         proxy {
           https {
             host = "example-hostname"
             port = 443
           }
         } 
       }
       ...
     }
   }
   ```
3. Save the `application_stackstate.conf` file.
4. Restart StackState to apply the configuration changes. All event handlers will now use the configured proxy.

## See also

* [Manage Event Handlers](/5.1/use/events/manage-event-handlers.md)
* [Custom event handler functions](/5.1/develop/developer-guides/custom-functions/event-handler-functions.md)
* [Enable email event notifications](/5.1/configure/topology/configure-email-event-notifications.md)
* [Akka HTTP(S) Proxy (docs.akka.io)](https://doc.akka.io/docs/akka-http/current/client-side/client-transport.html#http-s-proxy)