---
title: Enable Configuration Lock
description: When true, an agent restart is required to allow configuration changes, even for hot-swappable parameters.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.lock.config.enabled
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.lock.config.enabled.html
---

# Enable Configuration Lock

When `true`, an agent restart is required to allow configuration changes, even for hot-swappable parameters.

|                          |                                                                                                                                                      |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.lock.config.enabled`                                                                                                           |
| Aliases                  | `com.sun.identity.agents.config.lock.enable`   Introduced in Java Agent 5.0`org.forgerock.agents.lock.config.enabled`   Introduced in Java Agent 5.6 |
| Function                 | Profile                                                                                                                                              |
| Type                     | Boolean: `true` returns true; all other strings return `false`.                                                                                      |
| Default                  | `false`                                                                                                                                              |
| Bootstrap property       | Yes                                                                                                                                                  |
| Required property        | No                                                                                                                                                   |
| Restart required         | No                                                                                                                                                   |
| Local configuration file | `AgentBootstrap.properties`                                                                                                                          |