--- title: "xAgent configuration file reference" slug: "xagent-configuration-file-reference" updated: 2026-10-28T10:34:03Z published: 2026-10-28T10:34:03Z canonical: "docs.trellix.com/xagent-configuration-file-reference" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # xAgent configuration file reference The xAgent configuration file stores settings used by the agent as it monitors the host endpoint. These settings are stored in the `agent_config.json` file. This file is accessed and used when downloading the agent installation package from the Endpoint Security (HX) server, deploying agent to endpoints in your environment, and configuring the agent's settings to monitor your hosts and endpoints. ##### **xAgent** **configuration file setting support By OS platforms** You can use a text editor to modify the xAgent configuration file settings for your host Windows, macOS, or Linux endpoint. ### Important If you change values in the `agent_config.json` file without consulting Trellix Customer Support or in a manner not recommended by Trellix, your xAgent software functionality may be compromised. The table below lists the operating system support for each xAgent configuration file setting. | Section | Setting Key | Supported Operating System (Y=Yes or N=No) | | | --- | --- | --- | --- | | Windows | macOS | Linux | | | [advanced](/docs/advanced-section-settings) | [mg_intel](/docs/advanced-section-settings) | Y | N | N | | | [cleandb](/docs/advanced-section-settings) | Y | N | N | | | [Amsi](/docs/channel-setting) | [blockModeEnabled](/docs/credentials-section-settings) | Y | N | N | | | [contextDataSize](/docs/credentials-section-settings) | Y | N | N | | | [databaseSize](/docs/credentials-section-settings) | Y | N | N | | | [deleteTrigger](/docs/credentials-section-settings) | Y | N | N | | | [deleteBatchSize](/docs/credentials-section-settings) | Y | N | N | | | [debugOutputEnabled](/docs/credentials-section-settings) | Y | N | N | | | [enabled](/docs/credentials-section-settings) | Y | N | N | | | [intel_poll_sec](/docs/credentials-section-settings) | Y | N | N | | | [localRulesEnabled](/docs/credentials-section-settings) | Y | N | N | | | [selectedConfidence](/docs/credentials-section-settings) | Y | N | N | | | [channel](/docs/channel-setting) | --- | Y | Y | Y | | | [credentials](/docs/credentials-section-settings) | [cacert](/docs/credentials-section-settings) | Y | Y | Y | | | [provocert](/docs/credentials-section-settings) | Y | Y | Y | | | [provokey](/docs/credentials-section-settings) | Y | Y | Y | | | [EndpointUI](/docs/events-section-settings) | [daysToPurgeEventLogs](/docs/active-collection-enabled-key) | Y | N | N | | | [enabled](/docs/active-collection-enabled-key) | Y | N | N | | | [localDeleteEnabled](/docs/active-collection-enabled-key) | Y | N | N | | | [localRestoreEnabled](/docs/active-collection-enabled-key) | Y | N | N | | | [notificationsEnabled](/docs/active-collection-enabled-key) | Y | N | N | | | [trayIconEnabled](/docs/active-collection-enabled-key) | Y | N | N | | | [events](/docs/events-section-settings) | [active_collection_enabled](/docs/active-collection-enabled-key) | Y | Y | Y | | | [db_regen_errors](/docs/excludedpaths-key) | Y | Y | Y | | | [dns_evts_enabled](/docs/excludedpaths-key) | Y | Y | N | | | [excludedPaths](/docs/excludedpaths-key) | Y | Y | Y | | | [excludedProcessNames](/docs/excludedpaths-key) | Y | Y | Y | | | [intel_poll_sec](/docs/intel-poll-sec-key) | Y | Y | Y | | | [intel_uri](/docs/intel-uri-key) | Y | Y | Y | | | [max_db_size](/docs/max-db-size-key) | Y | Y | Y | | | [network_evts_enabled](/docs/max-db-size-key) | Y | Y | Y | | | [storage_mode](/docs/storage-mode-key) | Y | Y | Y | | | [udp_send_events](/docs/udp-send-events-key) | Y | Y | Y | | | [url_evts_enabled](/docs/udp-send-events-key) | Y | Y | N | | | [exploitDetection](/docs/exploitdetection-section-settings) | [alertThreshold](/docs/alertthreshold-key) | Y | N | N | | | [appList](/docs/applist-key) | Y | N | N | | | [config_uri](/docs/applist-key) | Y | N | N | | | [enable_notification](/docs/enable-notification-key) | Y | N | N | | | [enable_pageguard](/docs/enable-pageguard-key) | Y | N | N | | | [enable_prevent_known](/docs/enable-prevent-known-key) | Y | N | N | | | [enable_production](/docs/enable-production-key) | Y | N | N | | | [enable_protection](/docs/enable-protection-key) | Y | N | N | | | [enable_server_os](/docs/enable-server-os-key) | Y | N | N | | | [enable_termination](/docs/enable-termination-key) | Y | N | N | | | [enable_quarantine](/docs/enable-termination-key) | Y | N | N | | | [excludedFiles](/docs/excludedfiles-key) | Y | N | N | | | [excludedMD5s](/docs/excludedmd5s-key) | Y | N | N | | | [excludedPaths](/docs/excludedpaths-key-1) | Y | N | N | | | [rules_uri](/docs/rules-uri-key) | Y | N | N | | | [traceLevel](/docs/tracelevel-key) | Y | N | N | | | [whitelist_uri](/docs/whitelist-uri-key) | Y | N | N | | | [fips](/docs/fips-setting) | [enabled](/docs/fips-setting) | Y | Y | Y | | | [id](/docs/id-setting) | -- | Y | Y | Y | | | [logging](/docs/logging-section-settings) | [enabled](/docs/enabled-key) | Y | Y | Y | | | [log_level](/docs/log-level-key) | Y | Y | Y | | | [log_mask](/docs/log-mask-key) | Y | Y | Y | | | [max_count](/docs/log-mask-key) | Y | Y | Y | | | [LogonTracker](/docs/logging-section-settings) | [backfill_events](/docs/enabled-key) | Y | N | N | | | [enabled](/docs/enabled-key) | Y | N | Y | | | [ignore_accounts](/docs/enabled-key) | Y | N | N | | | [ignore_addr](/docs/enabled-key) | Y | N | N | | | [ignore_categories](/docs/enabled-key) | Y | N | N | | | [ignore_hosts](/docs/enabled-key) | Y | N | N | | | [include_status](/docs/enabled-key) | Y | N | N | | | [ignore_types](/docs/enabled-key) | Y | N | N | | | [logon_timeout_minutes](/docs/enabled-key) | Y | N | N | | | [malwareDetection](/docs/malwaredetection-section-settings) | [clean32_uri](/docs/clean32-uri-key) | Y | Y | N | | | [clean64_uri](/docs/clean64-uri-key) | Y | Y | N | | | [custom_server_host](/docs/clean64-uri-key) | Y | Y | N | | | [dti_exclusions_uri](/docs/clean64-uri-key) | Y | Y | N | | | [enable](/docs/enable-key) | Y | Y | N | | | [engine_configuration](/docs/enable-key) | Y | N | N | | | [enable_content_rollback](/docs/enable-key) | Y | Y | N | | | [enable_white_list](/docs/enable-key) | Y | Y | N | | | [excludedFiles](/docs/excludedfiles-key-1) | Y | Y | N | | | [excludedMD5s](/docs/excludedmd5s-key-1) | Y | Y | N | | | [excludeProcesses](/docs/excludedprocesses-key) | Y | Y | N | | | [mg_intel_uri](/docs/malwaredetection-network-oas-section-settings) | Y | N | N | | | [network_oas](/docs/malwaredetection-network-oas-section-settings) | Y | N | N | | | [ods](/docs/malwaredetection-network-oas-section-settings) | Y | Y | N | | | [quarantine](/docs/malwaredetection-quarantine-section-settings) | Y | Y | N | | | [scan_configuration](/docs/malwaredetection-quarantine-section-settings) | Y | Y | N | | | [scan_control](/docs/malwaredetection-quarantine-section-settings) | Y | Y | N | | | [schedulelist](/docs/malwaredetection-quarantine-section-settings) | Y | Y | N | | | [update_enabled](/docs/update-enabled-key) | Y | Y | N | | | [update_interval](/docs/update-interval-key) | Y | Y | N | | | [update_version_exclusions](/docs/update-interval-key) | Y | Y | N | | | [update_source](/docs/update-source-key) | Y | Y | N | | | [update_url32](/docs/update-url32-key) | Y | Y | N | | | [update_url64](/docs/update-url64-key) | Y | Y | N | | | [user_exclusions_uri](/docs/update-url64-key) | Y | Y | N | | | [name](/docs/name-setting) | --- | Y | Y | Y | | [ProcGuard](/docs/name-setting) | [blockingMode](/docs/cpu-limit-key) | Y | N | N | | | [enabled](/docs/cpu-limit-key) | Y | N | N | | | [excludedPaths](/docs/cpu-limit-key) | Y | N | N | | | [throttleIntervalSeconds](/docs/cpu-limit-key) | Y | N | N | | | [process](/docs/process-section-settings) | [cpu_limit](/docs/cpu-limit-key) | Y | Y | Y | | | [deny_local_admin_stop](/docs/deny-local-admin-stop-key) | Y | Y | Y | | | [file_protection_enabled](/docs/deny-local-admin-stop-key) | Y | N | N | | | [priority](/docs/priority-key) | Y | N | N | | | [protection_enabled](/docs/protection-enabled-key) | Y | N | N | | | [uninstall_password](/docs/uninstall-password-key) | Y | N | N | | | [ProtectionServices](/docs/protectionservices-settings) | [enable](/docs/protectionservices-enable-key) | Y | Y | Y | | | [age_to_purge](/docs/protectionservices-age-to-purge-key) | Y | Y | Y | | | [proxy](/docs/proxy-server-section-settings) | [type](/docs/proxy-type-key) | Y | Y | Y | | | [host](/docs/proxy-host-key) | Y | Y | Y | | | [port](/docs/proxy-port-key) | Y | Y | Y | | | [exclude_hosts](/docs/proxy-exclude-hosts-key) | Y | Y | Y | | | [exclude_local_hosts](/docs/exclude-local-hosts-key) | Y | Y | Y | | | [username](/docs/proxy-username-key) | Y | Y | Y | | | [password](/docs/proxy-password-key) | Y | Y | Y | | | [failed_retry_delay](/docs/proxy-failed-relay-delay-key) | Y | Y | Y | | | [serverlist](/docs/serverlist-section-settings) | [disable_provision](/docs/disable-provision-key) | Y | Y | Y | | | [server](/docs/server-key) | Y | Y | Y | | | [servers](/docs/servers-key) | Y | Y | Y | | | [service](/docs/service-section-settings) | [config_poll_interval_sec](/docs/config-poll-interval-sec-key) | Y | Y | Y | | | [config_pull_enabled](/docs/config-pull-enabled-key) | Y | Y | Y | | | [fastpoll_agents](/docs/config-pull-enabled-key) | Y | Y | Y | | | [poll_agents](/docs/config-pull-enabled-key) | Y | Y | Y | | | [request_sysinfo](/docs/config-pull-enabled-key) | Y | Y | Y | | | [ts](/docs/ts-setting) | --- | Y | Y | Y | | | [type](/docs/type-setting) | --- | Y | Y | Y | | | UACProtect | block_on_detection | Y | N | N | | | enabled | Y | N | N | | | hkcu_hijaking_com_handler | Y | N | N | | | hkcu_hijacking_environment | Y | N | N | | | hkcu_hijacking_shell_command | Y | N | N | | | process_masquerading | Y | N | N | | | ignore_wow64 | Y | N | N | | | ignore_duplicates | Y | N | N | | | program_output_abuse | Y | N | N | | | token_manipulation | Y | N | N | | | [version](/docs/version-setting) | --- | Y | Y | Y | | ### xAgent configuration file settings and default values The following table lists all settings in the `agent_config.json` file, defines their default values, and identifies the edit methods that are supported by Trellix for each setting. ### Important The **Supported Edit Methods** column in the table below identifies the edit methods that Trellix recommends you use to change a setting. Even if a setting can be modified using one of the available edit methods (for example, through [API custom configuration channels](/docs/using-api-custom-configuration-channels)), Trellix may not recommend that you do so. For information about the edit methods, see [Modifying Agent Configuration Settings](/docs/modifying-xagent-configuration-settings). Any setting can be changed manually for the agent on an individual host using a text editor. See [Modifying the Configuration File for a Single Endpoint](/docs/modifying-the-configuration-file-for-a-single-endpoint). Select a setting below to determine its supported edit methods. Admin users must have experience working with json files and understanding json file syntax. Select a section or setting key in the table below for more information. | Section | Setting Key | Default | Supported Edit Methods (Y=Yes or N=No) | | | --- | --- | --- | --- | --- | | UI | CLI | API | | | [advanced](/docs/advanced-section-settings) | [mg_intel](/docs/advanced-section-settings) | 300 | Y | N | Y | | | [cleandb](/docs/advanced-section-settings) | 300 | Y | N | Y | | | [Amsi](/docs/channel-setting) | [blockModeEnabled](/docs/credentials-section-settings) | false | N | N | Y | | | [contextDataSize](/docs/credentials-section-settings) | 1 | Y | N | Y | | | [databaseSize](/docs/credentials-section-settings) | 100 | Y | N | Y | | | [deleteTrigger](/docs/credentials-section-settings) | 80 | Y | N | Y | | | [deleteBatchSize](/docs/credentials-section-settings) | 100 | Y | N | Y | | | [debugOutputEnabled](/docs/credentials-section-settings) | false | N | N | Y | | | [enabled](/docs/credentials-section-settings) | --- | N | N | Y | | | [intel_poll_sec](/docs/credentials-section-settings) | 3600 | Y | N | Y | | | [intel_uri](/docs/credentials-section-settings) | --- | N | N | Y | | | [localRulesEnabled](/docs/credentials-section-settings) | false | N | N | Y | | | [selectedConfidence](/docs/credentials-section-settings) | medium | Y | N | Y | | | [selectLimit](/docs/credentials-section-settings) | 1000 | Y | N | Y | | | [channel](/docs/channel-setting) | --- | --- | N | N | N | | | [credentials](/docs/credentials-section-settings) | [cacert](/docs/credentials-section-settings) | --- | N | N | N | | | [provocert](/docs/credentials-section-settings) | --- | N | N | N | | | [provokey](/docs/credentials-section-settings) | --- | N | N | N | | | [EndpointUI](/docs/events-section-settings) | [daysToPurgeEventLogs](/docs/active-collection-enabled-key) | 30 | Y | N | Y | | | [enabled](/docs/active-collection-enabled-key) | --- | Y | N | Y | | | [localDeleteEnabled](/docs/active-collection-enabled-key) | true | Y | N | Y | | | [localRestoreEnabled](/docs/active-collection-enabled-key) | true | Y | N | Y | | | [notificationsEnabled](/docs/active-collection-enabled-key) | false | N | N | Y | | | [trayIconEnabled](/docs/active-collection-enabled-key) | true | N | N | Y | | | [events](/docs/events-section-settings) | [active_collection_enabled](/docs/active-collection-enabled-key) | true | Y | N | Y | | | [db_regen_errors](/docs/excludedpaths-key) | --- | N | N | N | | | [dns_evts_enabled](/docs/excludedpaths-key) | --- | Y | N | Y | | | [excludedPaths](/docs/excludedpaths-key) | --- | Y | N | Y | | | [excludedProcessNames](/docs/excludedpaths-key) | --- | Y | N | Y | | | [intel_poll_sec](/docs/intel-poll-sec-key) | 900 | Y | Y | Y | | | [intel_uri](/docs/intel-uri-key) | /content/v1/intel/ioc/win-current_xagent_win | N | N | N | | | [max_db_size](/docs/max-db-size-key) | 100 (Windows); 120 (macOS) | Y | N | Y | | | [network_evts_enabled](/docs/storage-mode-key) | --- | Y | N | Y | | | [storage_mode](/docs/storage-mode-key) | --- | Y | N | Y | | | [url_evts_enabled](/docs/storage-mode-key) | --- | Y | N | Y | | | [udp_send_events](/docs/udp-send-events-key) | false | Y | N | Y | | | [exploitDetection](/docs/exploitdetection-section-settings) | [alertThreshold](/docs/alertthreshold-key) | --- | N | N | N | | | [appList](/docs/applist-key) | --- | N | N | N | | | [config_uri](/docs/applist-key) | --- | N | N | N | | | [enable_notification](/docs/enable-notification-key) | false | Y | N | Y | | | [enable_pageguard](/docs/enable-pageguard-key) | true | N | N | N | | | [enable_prevent_known](/docs/enable-prevent-known-key) | false | Y | N | Y | | | [enable_production](/docs/enable-production-key) | true | Y | N | Y | | | [enable_protection](/docs/enable-protection-key) | false | Y | N | Y | | | [enable_server_os](/docs/enable-server-os-key) | false | Y | N | Y | | | [enable_termination](/docs/enable-termination-key) | false | Y | N | Y | | | [enable_quarantine](/docs/excludedfiles-key) | --- | Y | N | Y | | | [excludedFiles](/docs/excludedfiles-key) | --- | Y | N | Y | | | [excludedMD5s](/docs/excludedmd5s-key) | --- | Y | N | Y | | | [excludedPaths](/docs/excludedpaths-key-1) | --- | Y | N | Y | | | [rules_uri](/docs/rules-uri-key) | /content/v1/intel/exd/rules | N | N | N | | | [traceLevel](/docs/tracelevel-key) | --- | N | N | N | | | [whitelist_uri](/docs/whitelist-uri-key) | /content/v1/intel/exd/whitelist | N | N | N | | | [fips](/docs/fips-setting) | [enabled](/docs/fips-setting) | true | N | N | N | | | [id](/docs/id-setting) | -- | --- | N | N | N | | | [logging](/docs/logging-section-settings) | [enabled](/docs/enabled-key) | true | Y | N | Y | | | [log_level](/docs/log-level-key) | info | Y | N | Y | | | [log_mask](/docs/log-mask-key) | --- | N | N | Y | | | [max_count](/docs/log-mask-key) | --- | Y | N | Y | | | [LogonTracker](/docs/malwaredetection-section-settings) | [backfill_events](/docs/clean32-uri-key) | true | Y | N | Y | | | [enabled](/docs/clean32-uri-key) | --- | Y | N | Y | | | [ignore_accounts](/docs/clean32-uri-key) | --- | Y | N | Y | | | [ignore_addr](/docs/clean32-uri-key) | --- | Y | N | Y | | | [ignore_categories](/docs/clean32-uri-key) | --- | Y | N | Y | | | [ignore_hosts](/docs/clean32-uri-key) | --- | Y | N | Y | | | [include_status](/docs/clean32-uri-key) | --- | Y | N | Y | | | [ignore_types](/docs/clean32-uri-key) | --- | Y | N | Y | | | [logon_timeout_minutes](/docs/clean32-uri-key) | 1440 | Y | N | Y | | | [malwareDetection](/docs/malwaredetection-section-settings) | [clean32_uri](/docs/clean32-uri-key) | --- | N | N | N | | | [clean64_uri](/docs/clean64-uri-key) | --- | N | N | N | | | [custom_server_host](/docs/clean64-uri-key) | --- | Y | N | Y | | | [dti_exclusions_uri](/docs/clean64-uri-key) | --- | N | N | N | | | [enable](/docs/enable-key) | false | Y | N | Y | | | [enable_content_rollback](/docs/clean64-uri-key) | --- | Y | N | Y | | | [enable_white_list](/docs/clean64-uri-key) | --- | N | N | N | | | [engine_configuration](/docs/excludedfiles-key-1) | --- | Y | N | Y | | | [excludedFiles](/docs/excludedfiles-key-1) | --- | Y | N | Y | | | [excludedMD5s](/docs/excludedmd5s-key-1) | --- | Y | N | Y | | | [excludeProcesses](/docs/excludedprocesses-key) | --- | Y | N | Y | | | [mg_intel_uri](/docs/excludedprocesses-key) | --- | N | N | N | | | [network_oas](/docs/excludedprocesses-key) | --- | Y | N | Y | | | [ods](/docs/excludedprocesses-key) | --- | N | N | N | | | [quarantine](/docs/excludedprocesses-key) | --- | Y | N | Y | | | [scan_configuration](/docs/update-enabled-key) | --- | N | N | N | | | [scan_control](/docs/update-enabled-key) | --- | Y | N | Y | | | [schedulelist](/docs/update-enabled-key) | --- | Y | N | Y | | | [update_enabled](/docs/update-enabled-key) | false | N | N | N | | | [update_interval](/docs/update-interval-key) | 14400 seconds (4 hours) | Y | N | Y | | | [update_source](/docs/update-source-key) | Internet | Y | N | Y | | | [update_url32](/docs/update-url32-key) | http://avupdate.fireeye.com/av32bit | N | N | N | | | [update_url64](/docs/update-url64-key) | http://avupdate.fireeye.com/av64bit | N | N | N | | | | [update_version_exclusions](/docs/update-enabled-key) | --- | Y | N | Y | | [user_exclusions_uri](/docs/update-enabled-key) | --- | N | N | N | | | [name](/docs/name-setting) | --- | default | N | N | N | | | [ProcGuard](/docs/cpu-limit-key) | [blockingMode](/docs/cpu-limit-key) | false | Y | N | Y | | | | [enabled](/docs/cpu-limit-key) | --- | Y | N | Y | | | [excludedPaths](/docs/cpu-limit-key) | --- | Y | N | Y | | | [throttleIntervalSeconds](/docs/cpu-limit-key) | 3600 | Y | N | Y | | | [process](/docs/process-section-settings) | [cpu_limit](/docs/cpu-limit-key) | 100 | Y | Y | Y | | | [deny_local_admin_stop](/docs/deny-local-admin-stop-key) | true | Y | N | Y | | | [file_protection_enabled](/docs/uninstall-password-key) | --- | Y | N | Y | | | [priority](/docs/priority-key) | idle | Y | N | Y | | | [protection_enabled](/docs/protection-enabled-key) | true | Y | N | Y | | | [uninstall_password](/docs/uninstall-password-key) | --- | Y | N | Y | | | [ProtectionServices](/docs/protectionservices-settings) | [enable](/docs/protectionservices-enable-key) | true | N | Y | Y | | | [age_to_purge](/docs/protectionservices-age-to-purge-key) | 90 | Y | Y | Y | | | [proxy](/docs/proxy-server-section-settings) | [type](/docs/proxy-type-key) | none | Y | Y | Y | | | [host](/docs/proxy-host-key) | --- | Y | Y | Y | | | [port](/docs/proxy-port-key) | 80 | Y | Y | Y | | | [exclude_hosts](/docs/proxy-exclude-hosts-key) | --- | Y | Y | Y | | | [exclude_local_hosts](/docs/exclude-local-hosts-key) | false | Y | Y | Y | | | [username](/docs/proxy-username-key) | --- | Y | Y | Y | | | [password](/docs/proxy-password-key) | --- | Y | Y | Y | | | [failed_retry_delay](/docs/proxy-failed-relay-delay-key) | 1200 | Y | Y | Y | | | [serverlist](/docs/serverlist-section-settings) | [disable_provision](/docs/disable-provision-key) | false | Y | N | Y | | | [server](/docs/server-key) | --- | Y | Y | N | | | [servers](/docs/servers-key) | --- | Y | N | Y | | | [service](/docs/service-section-settings) | [config_poll_interval_sec](/docs/config-poll-interval-sec-key) | 900 | Y | N | Y | | | [config_pull_enabled](/docs/config-pull-enabled-key) | true | N | N | N | | | [fastpoll_agents](/docs/config-pull-enabled-key) | --- | N | Y | Y | | | [poll_agents](/docs/config-pull-enabled-key) | --- | Y | Y | Y | | | [request_sysinfo](/docs/config-pull-enabled-key) | --- | Y | N | Y | | | [ts](/docs/ts-setting) | --- | --- | N | N | N | | | [type](/docs/type-setting) | --- | --- | N | N | N | | | UACProtect | block_on_detection | false | Y | N | Y | | | enabled | --- | Y | N | Y | | | hijaking_com_handler | true | Y | N | Y | | | hkcu_hijacking_environment | true | Y | N | Y | | | hkcu_hijacking_shell_command | true | Y | N | Y | | | process_masquerading | true | Y | N | Y | | | ignore_wow64 | false | Y | N | Y | | | ignore_duplicates | true | Y | N | Y | | | program_output_abuse | true | Y | N | Y | | | token_manipulation | true | Y | N | Y | | | [version](/docs/version-setting) | --- | --- | N | N | N | | :