> This page is for Itential Gateway, version 5 (default).
> For other versions, use one of these documentation indexes:
> - 5 (default): https://docs-test.itntl.com/itential-gateway/5/llms.txt
> - 4: https://docs-test.itntl.com/itential-gateway/4/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-test.itntl.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-test.itntl.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`