---
title: System properties
description: Reference for PingGateway reserved system properties, including instance directory, transaction header trust, form decoding, JWT decompression, and ECDSA signing settings
component: pinggateway
version: 2026
page_id: pinggateway:reference:SystemProperties
canonical_url: https://docs.pingidentity.com/pinggateway/2026/reference/SystemProperties.html
llms_txt: https://docs.pingidentity.com/pinggateway/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-06-01T16:50:04Z
---

# System properties

PingGateway supports the following reserved system properties. The names have special meanings in PingGateway. Use them only for their stated purpose:

* `ig.instance.dir`, `IG_INSTANCE_DIR`

  The full path to the directory containing configuration and data for the PingGateway instance.

  Default: Linux, `$HOME/.openig`; Windows, `%appdata%\OpenIG`

  For information about how to use a different location, refer to [Configuration location](../configure/configure.html#configuration-location).

* `org.forgerock.http.TrustTransactionHeader`

  When this property is `true`, PingGateway trusts all incoming `X-ForgeRock-TransactionId` headers. Monitoring and reporting systems consuming the logs can correlate requests as they traverse multiple servers.

  Default: `false`

* `org.forgerock.http.util.ignoreFormParamDecodingError`

  When this property is `true`, PingGateway ignores form encoding errors caused by invalid characters and uses encoded values instead.

  Default: `false`

* `org.forgerock.json.jose.jwe.compression.max.decompressed.size.bytes`

  The maximum size in bytes to which a compressed JWT can be decompressed.

  Default: 32 KBytes

* `org.forgerock.secrets.preferDeterministicEcdsa`

  When this property is `true` and the following conditions are met, PingGateway signs JWTs with a deterministic Elliptic Curve Digital Signature Algorithm (ECDSA):

  * ECDSA is used for signing

  * Bouncy Castle is installed

  Default: `true`