---
title: Local Agent Debug File Name
description: The local file in which the agent writes debug log messages after startup.
component: web-agents
version: 2025.11
page_id: web-agents:properties-reference:com.sun.identity.agents.config.local.logfile
canonical_url: https://docs.pingidentity.com/web-agents/2025.11/properties-reference/com.sun.identity.agents.config.local.logfile.html
---

# Local Agent Debug File Name

The local file in which the agent writes debug log messages after startup.

During agent startup the location of the logs can be based on the container which is being used, or defined in the site configuration file for the server. For example, bootstrap logs for NGINX Plus Web Agent can be written to `/var/log/nginx/error.log`.

Default: `/web_agents/agent_type/instances/agent_nnn/logs/debug/debug.log`

|                    |                                                                              |
| ------------------ | ---------------------------------------------------------------------------- |
| Property name      | `com.sun.identity.agents.config.local.logfile`   Introduced in Web Agent 4.x |
| Function           | Logs                                                                         |
| Type               | String                                                                       |
| Bootstrap property | Yes                                                                          |
| Required property  | No                                                                           |
| Restart required   | No                                                                           |