diff --git a/doc/install.rst b/doc/install.rst
index ec1c6ab3d0721947a3d73c36b271b93c99e1d4e9..8f753d656c2cac3dbd0d525b49268ea80568ab13 100644
--- a/doc/install.rst
+++ b/doc/install.rst
@@ -721,10 +721,19 @@ modify``.
 Your instance types, networking environment, hypervisor type and version
 may all affect what kind of parameters should be used on your cluster.
 
-For example kvm instances are by default configured to use a host
-kernel, and to be reached via serial console, which works nice for Linux
-paravirtualized instances. If you want fully virtualized instances you
-may want to handle their kernel inside the instance, and to use VNC.
+.. admonition:: KVM
+
+  Instances are by default configured to use a host kernel, and to be
+  reached via serial console, which works nice for Linux paravirtualized
+  instances. If you want fully virtualized instances you may want to
+  handle their kernel inside the instance, and to use VNC.
+
+  Some versions of KVM have a bug that will make an instance hang when
+  configured to use the serial console (which is the default) unless a
+  connection is made to it within about 2 seconds of the instance's
+  startup. For such case it's recommended to disable the
+  ``serial_console`` option.
+
 
 Joining the nodes to the cluster
 ++++++++++++++++++++++++++++++++
diff --git a/man/gnt-instance.rst b/man/gnt-instance.rst
index 6fe996b7a3eb34c3df06b4dcec2e3ef124bbc086..d5c7d098c09ac36f28371405a3abebd906874d6a 100644
--- a/man/gnt-instance.rst
+++ b/man/gnt-instance.rst
@@ -492,7 +492,11 @@ serial\_console
     Valid for the KVM hypervisor.
 
     This boolean option specifies whether to emulate a serial console
-    for the instance.
+    for the instance. Note that some versions of KVM have a bug that
+    will make an instance hang when configured to use the serial console
+    unless a connection is made to it within about 2 seconds of the
+    instance's startup. For such case it's recommended to disable this
+    option, which is enabled by default.
 
 serial\_speed
     Valid for the KVM hypervisor.