Override default configuration

StackState Self-hosted v4.5.x

This page describes StackState v4.5.x. The StackState 4.5 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.5 version range to upgrade to a more recent release.

Go to the documentation for the latest StackState release.

A number of values can be set in the StackState Helm chart. For example, it is possible to customize the tolerations and nodeSelectors for each of the components. You can also add customized configuration and include environment variables

Custom configuration for StackState api

For the StackState api service, custom configuration can be dropped directly into the Helm chart. This is the advised way to override the default configuration that StackState ships with and is especially convenient for customizing authentication. Configuration set in this way will be available to the StackState configuration file in HOCON format.

For example, you can set a custom "forgot password link" for the StackState login page:

values.yaml

stackstate:
  components:
    api:
      config: |
        stackstate.api.authentication.forgotPasswordLink =
        "https://www.stackstate.com/forgotPassword.html"

Note that custom configuration set here will be overridden by environment variables.

Environment variables

The configuration for all of the StackState services (receiver, k2es-*, correlation and api) can be customized using environment variables. Environment variables are specified in the values.yaml file and can be either secret (such as passwords) or open (for normal values). To convert a configuration item to an environment variable name, replace . with _ and add the prefix CONFIG_FORCE_.

# configuration item
stackstate.api.authentication.forgotPasswordLink

# environment variable name
CONFIG_FORCE_stackstate_api_authentication_forgotPasswordLink

For example, you can set a custom "forgot password link" for the StackState login page:

values.yaml

stackstate:
  components:
    api:
      extraEnv:
        # Use 'secret:' to add configuration that should be stored as a secret
        open:
          CONFIG_FORCE_stackstate_api_authentication_forgotPasswordLink:
          "https://www.stackstate.com/forgotPassword.html"

For the StackState api service, environment variables will override custom configuration set using config.

• Full details on the naming of all the different services can be found in the in the StackState Helm chart readme.

• Find more details on customizing authentication.