From 489389b98c4c4e2e6e8e8844b3d5c464873ee7ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mois=C3=A9s=20Gonz=C3=A1lez?= <moises.gonzalez@edunext.co>
Date: Thu, 14 May 2026 09:35:33 -0400
Subject: [PATCH] docs: warn about the ingress objects renaming consequences

---
 CHANGELOG.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index edb8541..a29d5a0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,15 @@ See the fragment files in the [changelog.d/ directory](./changelog.d).
   `-tls` was also removed from additional ingresses defined via
   `DRYDOCK_INGRESS_EXTRA_HOSTS`.
 
+> [!WARNING]
+>
+> This rename will cause errors with the Ingress NGINX validation webhook
+> due to two different ingress objects registering the same routes.
+>
+> The old ingress objects must be deleted before applying the new
+> changes. Either perform a manual delete or set `DRYDOCK_INGRESS` to false
+> to delete all ingress objects in the next apply.
+
 <a id='changelog-21.1.0'></a>
 ## 21.1.0 — 2026-04-17