From 3f9ee5013d8f829b173fd2dd17475b85c63f73eb Mon Sep 17 00:00:00 2001
From: Ian Fowler <77341519+ianf77@users.noreply.github.com>
Date: Mon, 9 Feb 2026 13:36:41 +0000
Subject: [PATCH] Add note to procedure (#5591)

Update Documentation Regarding Remote Host Headers Setting

https://issues.redhat.com/browse/AAP-64995
---
 .../platform/proc-controller-configure-system.adoc        | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/downstream/modules/platform/proc-controller-configure-system.adoc b/downstream/modules/platform/proc-controller-configure-system.adoc
index eae5b290ad..b753fc42db 100644
--- a/downstream/modules/platform/proc-controller-configure-system.adoc
+++ b/downstream/modules/platform/proc-controller-configure-system.adoc
@@ -45,6 +45,14 @@ If *Gather data for {Analytics}* is set to false, this value is ignored.
 * *Remote Host Headers*: HTTP headers and meta keys to search to decide remote hostname or IP. 
 Add additional items to this list, such as `HTTP_X_FORWARDED_FOR`, if behind a reverse proxy. 
 For more information, see link:{URLAAPOperationsGuide}/assembly-configuring-proxy-support[Configuring proxy support for {PlatformName}].
++
+[Important]
+====
+If a setting is defined in a file (such as a python file or a custom YAML file) or an environment variable, it is considered a hard directive from {PlatformNameShort} infrastructure. 
+The platform regards files on the server to be the official source of truth. 
+If that occurs, UI changes in the *Remote Host Headers* field cannot override the contents of the file. 
+This makes *Remote Host Headers* read-only.
+====
 * *Automation Analytics upload URL*: This value has been set manually in a settings file. 
 This setting is used to configure the upload URL for data collection for Automation Analytics.
 * *Defines subscription usage model and shows Host Metrics*: