Skip to main content

Temporal Web UI configuration reference

The Temporal Web UI Server uses a configuration file for many of the UI's settings.

An example development.yaml file can be found in the temporalio/ui-server repo.

Multiple configuration files can be created for configuring specific areas of the UI, such as Auth or TLS.

enableUi​

Enables the browser UI. This configuration can be set dynamically with the TEMPORAL_UI_ENABLED environment variable. If disabled—that is, set to false—the UI server APIs remain available.

enableUi: true

enableOpenApi​

Enables the UI Server's Open API reference documentation at /openapi/. This configuration can be set dynamically with the TEMPORAL_OPEN_API_ENABLED environment variable. For example, if you are currently viewing the Web UI at http://localhost:8080, the page is available at localhost:8080/openapi/.

enableOpenApi: true

cors​

The name of the cors field stands for Cross-Origin Resource Sharing. Use this field to provide a list of domains that are authorized to access the UI Server APIs.

cors:
  allowOrigins:
    - http://localhost:3000 # used at development by https://github.com/temporalio/ui

refreshInterval​

How often the configuration UI Server reads the configuration file for new values. Currently, only tls configuration values are propagated during a refresh.

refreshInterval: 1m

temporalGrpcAddress​

The frontend adddress for the Temporal Cluster.

The default address is localhost (127.0.0.1:7233).

temporalGrpcAddress: default

port​

The port used by the Temporal Web UI Server and any APIs.

port: 8080

defaultNamespace​

The default Namespace that the UI loads data for. Defaults to default.

defaultNamespace: default

showTemporalSystemNamespace​

When enabled—that is, when set to true—the Temporal System Namespace becomes visible in the UI. The Temporal System Namespace lists Workflow Executions used by the Temporal Platform.

showTemporalSystemNamespace: false

feedbackUrl​

The URL to direct users to when they click on the Feedback button in the UI. If not specified, it defaults to the UI's GitHub Issue page.

feedbackUrl: https://github.com/temporalio/ui/issues/new/choose

notifyOnNewVersion​

When enabled—that is, when set to true—a notification appears in the UI when a newer version of the Temporal Server is available.

notifyOnNewVersion: true

auth​

Auth configuration.

auth:
  enabled: false
  providers:
    - label: Auth0 oidc # for internal use; in future may expose as button text
      type: oidc # for futureproofing; only oidc is supported today
      providerUrl: https://myorg.us.auth0.com/
      clientId: xxxxxxxxxxxxxxxxxxxx
      clientSecret: xxxxxxxxxxxxxxxxxxxx
      scopes:
        - openid
        - profile
        - email
      callbackUrl: http://localhost:8080/auth/sso/callback
      passIdToken: false
      options: # added as URL query params when redirecting to auth provider
        audience: myorg-dev
        organization: org_xxxxxxxxxxxx
        invitation:

tls​

Transport Layer Security (TLS) configuration.

tls:
  caFile:
  certFile:
  keyFile:
  caData:
  certData:
  keyData:
  enableHostVerification: false
  serverName:

codec​

Codec Server configuration.

codec:
  endpoint: http://your-codec-server-endpoint
  passAccessToken: false

disableWriteActions​

Prevents the user from executing Workflow Actions on the Web UI.

This option affects Bulk Actions for Recent Workflows as well as Workflow Actions on the Workflow Details page.

disableWriteActions: false
note

disableWriteActions overrides the configuration values of each individual Workflow Action. Setting this variable to true disables all Workflow Actions on the Web UI.

workflowTerminatedDisabled​

Prevents the user from terminating Workflow Executions from the Web UI.

workflowTerminatedDisabled: false

workflowCancelDisabled​

Prevents the user from canceling Workflow Executions from the Web UI.

workflowCancelDisabled: false

workflowSignalDisabled​

Prevents the user from signaling Workflow Executions from the Web UI.

workflowSignalDisabled: false

workflowResetDisabled​

Prevents the user from resetting Workflows from the Web UI.

workflowResetDisabled: false