diff --git a/doc/stake-pool-operations/core_relay.md b/doc/stake-pool-operations/core_relay.md
index 52b5aee1ae9..19456669b25 100644
--- a/doc/stake-pool-operations/core_relay.md
+++ b/doc/stake-pool-operations/core_relay.md
@@ -44,3 +44,7 @@ Make your __relay node__ `talk` to your __block-producing__ node and __other rel
         }
       ]
     }
+
+**Note**: If you want to connect to IPv4 and IPv6 relays, you must either not
+specify host addresses when starting `cardano-node` or make sure to specify
+both an IPv4 and IPv6 host address.
diff --git a/doc/stake-pool-operations/getConfigFiles_AND_Connect.md b/doc/stake-pool-operations/getConfigFiles_AND_Connect.md
index 7704cce442a..22bdfae40ab 100644
--- a/doc/stake-pool-operations/getConfigFiles_AND_Connect.md
+++ b/doc/stake-pool-operations/getConfigFiles_AND_Connect.md
@@ -44,6 +44,7 @@ Get the complete list of available options with `cardano-node run --help`
   	                                specified slot
     -h,--help                       Show this help text
 
+**Note**: If you do not specify `--host-addr` nor `--host-ipv6-addr`, node will use the default IPv4 and IPv6 addresses (depending which addresses are available).  If one specifies one of them only that address will be used, in particular if you only provide an IPv4 address, the node will not connect over IPv6.
 To start a passive node:
 
      cardano-node run \