---
title: Hostname to IP Address Map
description: Map of hostname to an IP address. The mapped hostname is automatically resolved to the IP address.
component: web-agents
version: 2025.11
page_id: web-agents:properties-reference:com.forgerock.agents.config.hostmap
canonical_url: https://docs.pingidentity.com/web-agents/2025.11/properties-reference/com.forgerock.agents.config.hostmap.html
---

# Hostname to IP Address Map

Map of hostname to an IP address. The mapped hostname is automatically resolved to the IP address.

* Map key: Hostname

* Map value: IP address

Configure this property in `agent.conf` or in the `Advanced` tab of the XUI.

Format: `com.forgerock.agents.config.hostmap[0]=<Hostname>|<IP>`

Example: `com.forgerock.agents.config.hostmap[0]=am.localtest.me|10.199.0.2`

|                    |                                                                     |
| ------------------ | ------------------------------------------------------------------- |
| Property name      | `com.forgerock.agents.config.hostmap`   Introduced in Web Agent 5.0 |
| Function           | General                                                             |
| Type               | String List                                                         |
| Bootstrap property | Yes                                                                 |
| Required property  | No                                                                  |
| Restart required   | No                                                                  |
| AM console         | Tab: `Advanced (From AM 7.2)`Title: `Hostname to IP Address Map`    |