> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Runner variables

> Configure runner nodes.

## GATEWAY\_RUNNER\_ANNOUNCEMENT\_ADDRESS

Sets the address that a gateway runner registers to its cluster when it comes online. When a gateway core server sends a service execution request to a gateway runner, it sends the request to this address. If you don't explicitly set this variable, the gateway runner identifies its own IP address and registers it to the cluster.

### Environment Variable

`GATEWAY_RUNNER_ANNOUNCEMENT_ADDRESS`

### File

**Section:** `runner`

**Key:** `announcement_address`

### Default

No default value provided

---

## GATEWAY\_RUNNER\_CERTIFICATE\_FILE

Sets the full path to the certificate file that the gateway runner uses when it connects to a gateway server. This setting is required when `GATEWAY_RUNNER_USE_TLS` is enabled.

### Environment Variable

`GATEWAY_RUNNER_CERTIFICATE_FILE`

### File

**Section:** `runner`

**Key:** `certificate_file`

### Default

No default value provided

---

## GATEWAY\_RUNNER\_LISTEN\_ADDRESS

Sets the listen address that a gateway runner uses to listen for service execution requests from a gateway server.

### Environment Variable

`GATEWAY_RUNNER_LISTEN_ADDRESS`

### File

**Section:** `runner`

**Key:** `listen_address`

### Default

`127.0.0.1`

---

## GATEWAY\_RUNNER\_PORT

Sets the port a gateway runner uses to listen for requests from a gateway server.

### Environment Variable

`GATEWAY_RUNNER_PORT`

### File

**Section:** `runner`

**Key:** `port`

### Default

`50051`

---

## GATEWAY\_RUNNER\_PRIVATE\_KEY\_FILE

Sets the full path to the private key file the gateway runner uses when it connects to a gateway server. This setting is required when `GATEWAY_RUNNER_USE_TLS` is enabled.

### Environment Variable

`GATEWAY_RUNNER_PRIVATE_KEY_FILE`

### File

**Section:** `runner`

**Key:** `private_key_file`

### Default

No default value provided

---

## GATEWAY\_RUNNER\_RUNTIME\_DATA\_DIR

Sets the location where the gateway stores virtual environments created during Python and Ansible service execution when you set  `GATEWAY_APPLICATION_MODE` to runner.

### Environment Variable

`GATEWAY_RUNNER_RUNTIME_DATA_DIR`

### File

**Section:** `runner`

**Key:** `runtime_data_dir`

### Default

`/var/lib/gateway`

---

## GATEWAY\_RUNNER\_USE\_TLS

Determines whether or not a gateway runner requires TLS when connecting to a gateway server.

### Environment Variable

`GATEWAY_RUNNER_USE_TLS`

### File

**Section:** `runner`

**Key:** `use_tls`

### Default

`true`