From 6046fa9b5f8c2a30f15ad39f18edcf8218b6808c Mon Sep 17 00:00:00 2001 From: Steffen Waldmann Date: Thu, 2 Oct 2025 10:27:49 +0200 Subject: [PATCH 1/5] Troubleshooting entry for "Cannot GET /" --- get-started/troubleshooting.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 5d0ce4e61..e597ff0df 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -626,8 +626,7 @@ Now you can build the archive with: mbt build -t gen --mtar mta.tar -e less.mtaext ``` -::: warning -This approach is only recommended +::: warning This approach is only recommended... - For test deployments during _development_. For _production_ deployments, self-contained archives are preferrable. - If all your dependencies are available in _public_ registries like npmjs.org or Maven Central. Dependencies from _corporate_ registries are not resolvable in this mode. ::: @@ -768,7 +767,13 @@ If you receive an error response `404 Not Found: Requested route ('') doe ::: +### Why do I get a "Cannot GET /"? +For security reasons, the index page shown in local development is **not served in production** by default. + +If you try to access your backend URL you will therefore see a "Cannot GET /". + +Only if absolutely required, you can enable this page in your deployment using cds.fiori.preview:true. ## CAP on Kyma From aaf75bd46482a787f87ff389429d89f5d13d1a23 Mon Sep 17 00:00:00 2001 From: Christian Georgi Date: Tue, 7 Oct 2025 13:22:14 +0200 Subject: [PATCH 2/5] Wording, links to Node and Java --- get-started/troubleshooting.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index e597ff0df..2bbefac50 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -767,13 +767,12 @@ If you receive an error response `404 Not Found: Requested route ('') doe ::: -### Why do I get a "Cannot GET /"? +### Why do I get a _404 Cannot GET /_ error? -For security reasons, the index page shown in local development is **not served in production** by default. +For security reasons, the **index page is not served in production** by default in both [Node.js](../node.js/cds-server#toggle-generic-index-page) and [Java](../java/developing-applications/configuring#production-profile). +If you try to access your backend URL, you will therefore see a _404 Cannot GET /_ error. -If you try to access your backend URL you will therefore see a "Cannot GET /". - -Only if absolutely required, you can enable this page in your deployment using cds.fiori.preview:true. +Only if absolutely required and you understand the security implications to your application, you can enable this page in your deployment using cds.server.index:true (Node.js) or [cds.indexPage.enabled:true](../java/developing-applications/properties#cds-indexPage) (Java). ## CAP on Kyma From 69214f4e8d9d3a4586394fb73e82c16f02b9e0fd Mon Sep 17 00:00:00 2001 From: Christian Georgi Date: Tue, 7 Oct 2025 13:26:56 +0200 Subject: [PATCH 3/5] Note on health status --- get-started/troubleshooting.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 2bbefac50..69ecbcedc 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -770,7 +770,9 @@ If you receive an error response `404 Not Found: Requested route ('') doe ### Why do I get a _404 Cannot GET /_ error? For security reasons, the **index page is not served in production** by default in both [Node.js](../node.js/cds-server#toggle-generic-index-page) and [Java](../java/developing-applications/configuring#production-profile). + If you try to access your backend URL, you will therefore see a _404 Cannot GET /_ error. +This also means you **cannot use the `/` path as a health status indicator**. See the [Health Checks guide](../guides/deployment/health-checks) for the correct paths. Only if absolutely required and you understand the security implications to your application, you can enable this page in your deployment using cds.server.index:true (Node.js) or [cds.indexPage.enabled:true](../java/developing-applications/properties#cds-indexPage) (Java). From c3fb5330d1ad799dcc124b0f52f786fcdb436384 Mon Sep 17 00:00:00 2001 From: Mahati Shankar <93712176+smahati@users.noreply.github.com> Date: Tue, 7 Oct 2025 14:26:47 +0200 Subject: [PATCH 4/5] Update get-started/troubleshooting.md --- get-started/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index 69ecbcedc..d971bd633 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -626,7 +626,7 @@ Now you can build the archive with: mbt build -t gen --mtar mta.tar -e less.mtaext ``` -::: warning This approach is only recommended... +::: warning Not recommended for production deployments - For test deployments during _development_. For _production_ deployments, self-contained archives are preferrable. - If all your dependencies are available in _public_ registries like npmjs.org or Maven Central. Dependencies from _corporate_ registries are not resolvable in this mode. ::: From 602aaf6076197ed935741664ec7416148dcda117 Mon Sep 17 00:00:00 2001 From: Christian Georgi Date: Wed, 8 Oct 2025 17:21:10 +0200 Subject: [PATCH 5/5] Avoid redundant config keys MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: René Jeglinsky --- get-started/troubleshooting.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/get-started/troubleshooting.md b/get-started/troubleshooting.md index d971bd633..e3de313b8 100644 --- a/get-started/troubleshooting.md +++ b/get-started/troubleshooting.md @@ -774,7 +774,9 @@ For security reasons, the **index page is not served in production** by default If you try to access your backend URL, you will therefore see a _404 Cannot GET /_ error. This also means you **cannot use the `/` path as a health status indicator**. See the [Health Checks guide](../guides/deployment/health-checks) for the correct paths. -Only if absolutely required and you understand the security implications to your application, you can enable this page in your deployment using cds.server.index:true (Node.js) or [cds.indexPage.enabled:true](../java/developing-applications/properties#cds-indexPage) (Java). +Only if absolutely required and you understand the security implications to your application, you can enable this page in your deployment. + +Learn more about the generic index page in [Java](../java/developing-applications/properties#cds-indexPage) and in [Node.js](../node.js/cds-server#toggle-generic-index-page).{.learn-more} ## CAP on Kyma