From 9260a8fa154b6bba559f0e46bf5597cbfaad7928 Mon Sep 17 00:00:00 2001
From: Matthias Schiffer <mschiffer@universe-factory.net>
Date: Tue, 19 Apr 2016 05:54:19 +0200
Subject: [PATCH] docs: add info about IPv6 and DNS requirements for
 NTP/autoupdater

---
 docs/user/faq.rst  | 14 ++++++++++++++
 docs/user/site.rst |  6 ++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/user/faq.rst b/docs/user/faq.rst
index 9da15270..f2e694e4 100644
--- a/docs/user/faq.rst
+++ b/docs/user/faq.rst
@@ -1,3 +1,17 @@
 Frequently Asked Questions
 ==========================
 
+.. _faq-dns:
+
+DNS does not work on the nodes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Gluon nodes will ignore the DNS server on the WAN port for evenything except
+the mesh VPN, which can lead to confusion.
+
+All normal services on the nodes exclusively use the DNS server on the mesh
+interface. This DNS server must be announced in router advertisements (using
+*radvd* or a similar software) from one or more central servers in meshes based
+on *batman-adv*. If your mesh does not have global IPv6 connectivity, you can setup
+your *radvd* not to announce a default route by setting the *default lifetime* to 0;
+in this case, the *radvd* is only used to announce the DNS server.
diff --git a/docs/user/site.rst b/docs/user/site.rst
index 146e991f..b757644c 100644
--- a/docs/user/site.rst
+++ b/docs/user/site.rst
@@ -46,6 +46,9 @@ ntp_server
 
        ntp_servers = {'1.ntp.services.ffeh','2.ntp.services.ffeh'}
 
+    This NTP servers must be reachable via IPv6 from the nodes. If you don't want to set an IPv6 address
+    explicitly, but use a hostname (which is recommended), see also the :ref:`FAQ <faq-dns>`.
+
 opkg : optional
     ``opkg`` package manager configuration.
 
@@ -249,6 +252,9 @@ autoupdater : package
         }
       }
 
+    All configured mirrors must be reachable from the nodes via IPv6. If you don't want to set an IPv6 address
+    explicitly, but use a hostname (which is recommended), see also the :ref:`FAQ <faq-dns>`.
+
 roles : optional
     Optional role definitions. Nodes will announce their role inside the mesh.
     This will allow in the backend to distinguish between normal, backbone and