diff --git a/docs/source/corda-configuration-file.rst b/docs/source/corda-configuration-file.rst
index 4c7a51059c..afc8c3c700 100644
--- a/docs/source/corda-configuration-file.rst
+++ b/docs/source/corda-configuration-file.rst
@@ -82,7 +82,9 @@ absolute path to the node's base directory.
     Currently the defaults in ``/node/src/main/resources/reference.conf`` are as shown in the first example. This is currently
     the only configuration that has been tested, although in the future full support for other storage layers will be validated.
 
-:h2port: A number that's used to pick the H2 JDBC server port. If not set a randomly chosen port will be used.
+:h2port: A number that's used to pick the H2 JDBC server port. If not set a randomly chosen port will be used. For production
+    use you will typically be using a different, non-H2 database backend (e.g. Oracle, SQL Server, Postgres) so this option
+    is intended primarily for developer mode.
 
 :messagingServerAddress: The address of the ArtemisMQ broker instance. If not provided the node will run one locally.