Skip to content

Commit 4b76c68

Browse files
swaldmannchgeosmahatirenejeglinsky
authored
Troubleshooting entry for missing index page and "Cannot GET /" (#2132)
Co-authored-by: Christian Georgi <[email protected]> Co-authored-by: Mahati Shankar <[email protected]> Co-authored-by: Christian Georgi <[email protected]> Co-authored-by: René Jeglinsky <[email protected]>
1 parent 6570dca commit 4b76c68

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

get-started/troubleshooting.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -626,8 +626,7 @@ Now you can build the archive with:
626626
mbt build -t gen --mtar mta.tar -e less.mtaext
627627
```
628628

629-
::: warning
630-
This approach is only recommended
629+
::: warning Not recommended for production deployments
631630
- For test deployments during _development_. For _production_ deployments, self-contained archives are preferrable.
632631
- 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.
633632
:::
@@ -768,7 +767,16 @@ If you receive an error response `404 Not Found: Requested route ('<route>') doe
768767
769768
:::
770769
770+
### Why do I get a _404 Cannot GET /_ error?
771771
772+
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).
773+
774+
If you try to access your backend URL, you will therefore see a _404 Cannot GET /_ error.
775+
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.
776+
777+
Only if absolutely required and you understand the security implications to your application, you can enable this page in your deployment.
778+
779+
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}
772780
773781
## CAP on Kyma
774782

0 commit comments

Comments
 (0)