For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationCommand referenceRelease notes
DocumentationCommand referenceRelease notes
  • Itential Automation Gateway
    • Overview
    • Execution engine
    • Concepts
    • Feature comparison
        • Create certificates
        • Initial configuration
        • Configure gateway client
        • Configure client profiles
        • Create cluster in Gateway Manager
        • High availability clusters
        • Distributed execution clusters
          • Overview
          • Application variables
          • Client variables
          • Connect variables
          • Features variables
          • Log variables
          • Registry variables
          • Runner variables
          • Secrets variables
          • Server variables
          • Store variables
          • Terminal variables
      • Migrate inventory to IAG 5
    • IAG secret store
    • Inventory Manager
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • GATEWAY_APPLICATION_CA_CERTIFICATE_FILE
  • Environment Variable
  • File
  • Default
  • GATEWAY_APPLICATION_CLUSTER_ID
  • Environment Variable
  • File
  • Default
  • GATEWAY_APPLICATION_MODE
  • File
  • Default
  • Possible Values
  • GATEWAY_APPLICATION_VENV_RETENTION_PERIOD
  • Environment Variable
  • File
  • Default
  • GATEWAY_APPLICATION_VENV_SWEEP_INTERVAL
  • Environment Variable
  • File
  • Default
  • GATEWAY_APPLICATION_WORKING_DIR
  • Environment Variable
  • File
  • Default
Itential Automation GatewayDeploy and manageConfigureConfiguration variables

Application variables

Was this page helpful?
Previous

Client variables

Next
Built with

GATEWAY_APPLICATION_CA_CERTIFICATE_FILE

When using certificates with TLS, this variable allows you to set the application CA. This is set on the application level since the CA should be used for all runner, server, and client implementations.

Environment Variable

GATEWAY_APPLICATION_CA_CERTIFICATE_FILE

File

Section: application

Key: ca_certificate_file

Default

No default value provided

GATEWAY_APPLICATION_CLUSTER_ID

The ID that uniquely identifies your gateway instance or a cluster of related gateway instances. This is also used to link a gateway controller node to Gateway Manager so that automations can be sent to a particular cluster.

Environment Variable

GATEWAY_APPLICATION_CLUSTER_ID

File

Section: application

Key: cluster_id

Default

cluster_1

GATEWAY_APPLICATION_MODE

Sets the operation mode that the application operates in. IAG can run in four distinct modes. For more information, see Application modes.

File

Section: application

Key: application_mode

Default

local

Possible Values

["local", "client", "server", "runner"]

GATEWAY_APPLICATION_VENV_RETENTION_PERIOD

IAG 5.4+

Sets how long a virtual environment may be idle before the pruner removes it. An environment is considered idle when it has not been used for a duration exceeding this value. Accepts Go duration strings (12h, 720h) or plain day values (1d, 30d).

Setting this value too low can cause environments to be pruned between uses, forcing a full dependency reinstall on the next execution.

For more information, see Python virtual environments.

Environment Variable

GATEWAY_APPLICATION_VENV_RETENTION_PERIOD

File

Section: application

Key: venv_retention_period

Default

30d

GATEWAY_APPLICATION_VENV_SWEEP_INTERVAL

IAG 5.4+

Sets how often the background pruner scans for idle virtual environments and removes those that exceed the retention period. Accepts Go duration strings (12h, 720h) or plain day values (1d, 30d).

For more information on virtual environment pruning, see Python virtual environments.

Environment Variable

GATEWAY_APPLICATION_VENV_SWEEP_INTERVAL

File

Section: application

Key: venv_sweep_interval

Default

24h

GATEWAY_APPLICATION_WORKING_DIR

Sets the location where the gateway stores various working files. Examples include the database when GATEWAY_STORE_BACKEND=local, the gateway.log file when you run the gateway as a client, and the SSH known_hosts file.

Environment Variable

GATEWAY_APPLICATION_WORKING_DIR

File

Section: application

Key: working_dir

Default

Home directory of user running gateway ~/.gateway.d