From 099a6b10d504a3ca5c4bd3272f2fa6e6bd01dd55 Mon Sep 17 00:00:00 2001
From: maliming <malimings@gmail.com>
Date: Tue, 17 Jun 2025 20:16:44 +0800
Subject: [PATCH] Add rewrite rules for getEnvConfig in Web.config for Angular
 deployment

---
 .../deployment/deployment-iis.md              | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/en/solution-templates/layered-web-application/deployment/deployment-iis.md b/docs/en/solution-templates/layered-web-application/deployment/deployment-iis.md
index 3d33cbd7a1..a70dfdd7bb 100644
--- a/docs/en/solution-templates/layered-web-application/deployment/deployment-iis.md
+++ b/docs/en/solution-templates/layered-web-application/deployment/deployment-iis.md
@@ -254,6 +254,36 @@ We can visit the websites from a browser.
 
 ![Tiered IIS deployment](../../../images/iis-sample-tiered-deployment.gif)
 
+{{ if UI == "NG" }}
+## Rewrite for getEnvConfig
+
+Please add the following rewrite rules to your `Web.config` file to redirect requests for `getEnvConfig` to `dynamic-env.json`, See [Angular RemoteEnvironment](https://abp.io/docs/latest/framework/ui/angular/environment#remoteenvironment) for more details.
+
+```xml
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+<system.webServer>
+ <rewrite>
+  <rules>
+    <rule name="Redirect" stopProcessing="true">
+      <match url="getEnvConfig" />
+      <action type="Redirect" url="dynamic-env.json" />
+    </rule>
+    <rule name="Angular Routes" stopProcessing="true">
+      <match url=".*" />
+      <conditions logicalGrouping="MatchAll">
+        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
+        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
+      </conditions>
+      <action type="Rewrite" url="./index.html" />
+    </rule>
+  </rules>
+ </rewrite>
+</system.webServer>
+</configuration>
+```
+{{ end }}
+
 ## Fix 405 Method Not Allowed Error
 
 Remove `WebDAV` modules and handlers from the `Web.config` file.