branch master updated: doc: Add a note about networking requirements for SSH access to VMs.

[guix-commits]

This is an automated email from the git hooks/post-receive script.

apteryx pushed a commit to branch master
in repository guix.

The following commit(s) were added to refs/heads/master by this push:
     new b9ac7d9  doc: Add a note about networking requirements for SSH access 
to VMs.
b9ac7d9 is described below

commit b9ac7d9aaaa5849cc3c2acd4b1b41acdd545e66b
Author: Maxim Cournoyer <maxim.cournoyer@gmail.com>
AuthorDate: Sun May 30 23:15:27 2021 -0400

    doc: Add a note about networking requirements for SSH access to VMs.
    
    Fixes <https://issues.guix.gnu.org/48739>.  It may seem silly, but when not
    realizing this firsthand, it can be quite surprising and thus not obvious to
    troubleshoot.  Thanks to Eric Brown for their insightful comments on the
    tracker.
    
    * doc/guix.texi (Running Guix in a VM): Add a note that networking support
    must be available in the Guix System operating system declaration used for 
the
    VM.
---
 doc/guix.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index dc10e88..0126099 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -33845,6 +33845,13 @@ every time you modify your @command{config.scm} file 
and the
 @command{-o StrictHostKeyChecking=no} prevents you from having to allow a
 connection to an unknown host every time you connect.
 
+@quotation Note
+If you find the above @samp{hostfwd} example not to be working (e.g.,
+your SSH client hangs attempting to connect to the mapped port of your
+VM), make sure that your Guix System VM has networking support, such as
+by using the @code{dhcp-client-service-type} service type.
+@end quotation
+
 @subsection Using @command{virt-viewer} with Spice
 
 As an alternative to the default @command{qemu} graphical client you can