diff --git a/spring-boot-docs/src/main/asciidoc/production-ready-features.adoc b/spring-boot-docs/src/main/asciidoc/production-ready-features.adoc
index 836ea30a897..85e3619abf9 100644
--- a/spring-boot-docs/src/main/asciidoc/production-ready-features.adoc
+++ b/spring-boot-docs/src/main/asciidoc/production-ready-features.adoc
@@ -737,6 +737,8 @@ the following dependency to your project:
 TIP: If you want to also enable telnet access you will additionally need a dependency
 on `org.crsh:crsh.shell.telnet`.
 
+NOTE: CRaSH requires to run with a JDK as it compiles commands on the fly. If a basic
+`help` command fails, you are probably running with a JRE.
 
 
 [[production-ready-connecting-to-the-remote-shell]]