diff --git a/modules/configuring/proc-provisioning-your-custom-configuration.adoc b/modules/configuring/proc-provisioning-your-custom-configuration.adoc index b55374b737..f4f41608fe 100644 --- a/modules/configuring/proc-provisioning-your-custom-configuration.adoc +++ b/modules/configuring/proc-provisioning-your-custom-configuration.adoc @@ -20,8 +20,14 @@ It contains one secret per line in `KEY=value` form. . Author your custom `{my-app-config-file}` file. This is the main {product-short} configuration file. -+ -The `baseUrl` field is mandatory in your `{my-app-config-file}` file to ensure proper functionality of {product-short}. You must specify the `baseUrl` in both the `app` and `backend` sections to avoid errors during initialization. +You need a custom `{my-app-config-file}` file to avoid the {product-short} installer to revert user edits during upgrades. +When your custom `{my-app-config-file}` file is empty, {product-short} is using default values. + +** To prepare a deployment with the {product} Operator on {ocp-short}, you can start with an empty file. + +** To prepare a deployment with the {product} Helm chart, or on Kubernetes, enter the {product-short} base URL in the relevant fields in your `{my-app-config-file}` file to ensure proper functionality of {product-short}. +The base URL is what a {product-short} user sees in their browser when accessing {product-short}. +The relevant fields are `baseUrl` in the `app` and `backend` sections, and `origin` in the `backend.cors` subsection: + .Configuring the `baseUrl` in `{my-app-config-file}` ==== @@ -43,13 +49,13 @@ backend: origin: {my-product-url} ---- ==== -+ -Optionally, enter your configuration such as: -* link:{authentication-book-url}[{authentication-book-title}]. -* link:{authorization-book-url}[{authorization-book-title}]. -* link:{customizing-book-url}[Customization]. -* xref:proc-configuring-an-rhdh-instance-with-tls-in-kubernetes_running-behind-a-proxy[Configure your {ocp-short} integration]. +** Optionally, enter your configuration such as: + +*** link:{authentication-book-url}[{authentication-book-title}]. +*** link:{authorization-book-url}[{authorization-book-title}]. +*** link:{customizing-book-url}[Customization]. +*** xref:proc-configuring-an-rhdh-instance-with-tls-in-kubernetes_running-behind-a-proxy[Configure your {ocp-short} integration]. . Provision your custom configuration files to your {ocp-short} cluster.