diff --git a/docs/source/shell.rst b/docs/source/shell.rst
index fa261a3bc3..de1e9f99cd 100644
--- a/docs/source/shell.rst
+++ b/docs/source/shell.rst
@@ -33,8 +33,10 @@ with the node using RPC calls.
 The shell via the local terminal
 --------------------------------
 
-In development mode, the shell will display in the node's terminal window.
-The shell connects to the node as 'shell' user with password 'shell' which is only available in dev mode.
+.. note::  Local terminal shell works only in development mode!
+
+The shell will display in the node's terminal window. It connects to the node as 'shell' user with password 'shell'
+(which is only available in dev mode).
 It may be disabled by passing the ``--no-local-shell`` flag when running the node.
 
 The shell via SSH