---
title: Alternative Agent Host Name
description: In environments when agents are behind a load balancer or reverse proxy which does a SSL offloading, the request URL is changed to match the URL that the agent receives.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.agent.hostname
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.agent.hostname.html
---

# Alternative Agent Host Name

In environments when agents are behind a load balancer or reverse proxy which does a SSL offloading, the request URL is changed to match the URL that the agent receives.

The agent then uses the new URL as the redirection value in the pre-authentication cookie, created during the first unauthenticated request to the agent.

Use the following properties to override the agent redirection value with the URL of the original client request: [Alternative Agent Port Number](org.forgerock.agents.agent.port.html) and [Alternative Agent Protocol](org.forgerock.agents.agent.protocol.html).

|                          |                                                                                                                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.agent.hostname`                                                                                                                                                                                 |
| Aliases                  | `com.sun.identity.agents.config.agent.host`   Introduced in Java Agent 5.0   [Recognized](preface.html#how_am_manages_multiple_aliases) from AM 6`org.forgerock.agents.agent.hostname`   Introduced in Java Agent 5.6 |
| Function                 | Agent                                                                                                                                                                                                                 |
| Type                     | String                                                                                                                                                                                                                |
| Bootstrap property       | No                                                                                                                                                                                                                    |
| Required property        | No                                                                                                                                                                                                                    |
| Restart required         | No                                                                                                                                                                                                                    |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                              |
| AM console               | Tab: `Advanced`Title: `Alternative Agent Host Name`                                                                                                                                                                   |