Update troubleshooting: On Gateway Timeout (#2535)

* Update troubleshooting.md * added versioned docs * lowercase * lowercase * style(formatting): technical review --------- Co-authored-by: Christina Ausley <[email protected]> Co-authored-by: christinaausley <[email protected]>
camunda · Sep 11, 2023 · 2c2c6c6 · 2c2c6c6
1 parent b061416
commit 2c2c6c6
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/docs/self-managed/platform-deployment/troubleshooting.md b/docs/self-managed/platform-deployment/troubleshooting.md
@@ -58,3 +58,7 @@ Due to limitations, the Identity `contextPath` approach is unavailable when usin
 ## Web Modeler database schema
 
 The Web Modeler `restapi` component requires a [database connection](../../modeler/web-modeler/configuration#database). This connection should not point to the same database as Keycloak does.
+
+## Gateway timeout on redirect
+
+A gateway timeout can occur if the headers of a response are too big (for example, if a JWT is returned as `Set-Cookie` header). To avoid this, you can increase the `proxy-buffer-size` of your Ingress Controller or Ingress. The setting for **ingress-nginx** can be found [here](https://github.com/kubernetes/ingress-nginx/blob/main/docs/user-guide/nginx-configuration/annotations.md#proxy-buffer-size).
diff --git a/versioned_docs/version-8.2/self-managed/platform-deployment/troubleshooting.md b/versioned_docs/version-8.2/self-managed/platform-deployment/troubleshooting.md
@@ -58,3 +58,7 @@ Due to limitations, the Identity `contextPath` approach is unavailable when usin
 ## Web Modeler database schema
 
 The Web Modeler `restapi` component requires a [database connection](../../modeler/web-modeler/configuration#database). This connection should not point to the same database as Keycloak does.
+
+## Gateway timeout on redirect
+
+A gateway timeout can occur if the headers of a response are too big (for example, if a JWT is returned as `Set-Cookie` header). To avoid this, you can increase the `proxy-buffer-size` of your Ingress Controller or Ingress. The setting for **ingress-nginx** can be found [here](https://github.com/kubernetes/ingress-nginx/blob/main/docs/user-guide/nginx-configuration/annotations.md#proxy-buffer-size).