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

# Server variables

> Configure gateway servers (controller nodes).

## GATEWAY\_SERVER\_API\_KEY\_EXPIRATION

The amount of time (in minutes) before a user API key expires.

### Environment Variable

`GATEWAY_SERVER_API_KEY_EXPIRATION`

### File

**Section:** `server`

**Key:** `api_key_expiration`

### Default

`1440`

---

## GATEWAY\_SERVER\_CERTIFICATE\_FILE

The full path to the certificate file the gateway server uses when it serves connections to gateway clients. This setting is required when `GATEWAY_SERVER_USE_TLS` is enabled.

### Environment Variable

`GATEWAY_SERVER_CERTIFICATE_FILE`

### File

**Section:** `server`

**Key:** `certificate_file`

### Default

No default value provided

---

## GATEWAY\_SERVER\_DISTRIBUTED\_EXECUTION

Determines whether a server node is an "all in one" deployment where services run on the same node as the actual server itself.
When you deploy a gateway architecture with separate runner nodes to execute services, set this variable to `true`.

### Environment Variable

`GATEWAY_SERVER_DISTRIBUTED_EXECUTION`

### File

**Section:** `server`

**Key:** `distributed_execution`

### Default

`false`

---

## GATEWAY\_SERVER\_GRPC\_MAX\_RECV\_MSG\_SIZE

Gateway 5.5.1+

Sets the maximum gRPC message size, in bytes, that Gateway accepts on all internal communication.

Values below `4194304` (4 MiB) are clamped to `4194304` at startup with a warning in the logs.

### Environment Variable

`GATEWAY_SERVER_GRPC_MAX_RECV_MSG_SIZE`

### File

**Section:** `server`

**Key:** `grpc_max_recv_msg_size`

### Default

`33554432` (32 MiB)

---

## GATEWAY\_SERVER\_LISTEN\_ADDRESS

Sets the address that a gateway server listens on.

### Environment Variable

`GATEWAY_SERVER_LISTEN_ADDRESS`

### File

**Section:** `server`

**Key:** `listen_address`

### Default

`127.0.0.1`

---

## GATEWAY\_SERVER\_PORT

Sets the port that a gateway server listens on.

### Environment Variable

`GATEWAY_SERVER_PORT`

### File

**Section:** `server`

**Key:** `port`

### Default

`50051`

---

## GATEWAY\_SERVER\_PRIVATE\_KEY\_FILE

The full path to the private key file that the gateway server uses when serving connections to gateway clients. Required when `GATEWAY_SERVER_USE_TLS`
is enabled.

### Environment Variable

`GATEWAY_SERVER_PRIVATE_KEY_FILE`

### File

**Section:** `server`

**Key:** `private_key_file`

### Default

No default value provided

---

## GATEWAY\_SERVER\_RUNTIME\_DATA\_DIR

The location where the gateway stores virtual environments created during Python and Ansible service execution when `GATEWAY_APPLICATION_MODE` is set to server.

### Environment Variable

`GATEWAY_SERVER_RUNTIME_DATA_DIR`

### File

**Section:** `server`

**Key:** `runtime_data_dir`

### Default

`/var/lib/gateway`

---

## GATEWAY\_SERVER\_USE\_TLS

Determines whether a gateway server requires TLS when serving connections to gateway clients.

### Environment Variable

`GATEWAY_SERVER_USE_TLS`

### File

**Section:** `server`

**Key:** `use_tls`

### Default

`true`

> Configure gateway servers (controller nodes).