From 7745d56644621cb0365d51ee5a284a36f5089dd6 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Sat, 28 Sep 2024 20:51:04 +0200
Subject: doc: Enable IPv6

soundbox should use IPv6 for streaming. IPv6 link-local addresses are
well-suited for soundbox devices since they are generated by the
hardware MAC address in this case.

This has the advantage that they do not need external infrastructure
like a DHCP server to be set up and that they are valid and unique for
the whole life cycle of the device. This makes network management
significantly easier.
---
 doc/documentation.tex | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'doc/documentation.tex')

diff --git a/doc/documentation.tex b/doc/documentation.tex
index 4e50eb0..3d4aa6b 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -222,6 +222,18 @@ setup-alpine
 These changes are only temporary until they are made persistent as described in
 section~\ref{lbu-persistence}.
 
+\subsection{Enabling IPv6}
+
+While Alpine Linux usually uses IPv4 only \texttt{soundbox} requires IPv6 for
+streaming. It can be enabled by adding a line to the related configuration
+file.
+
+\begin{verbatim}
+echo 'iface wlan0 inet6 auto' >> /etc/network/interfaces
+\end{verbatim}
+
+The change will take effect after the final reboot.
+
 \subsection{Package installation}
 
 soundbox requires packages from the Alpine Linux community package repository.
-- 
cgit v1.2.3-70-g09d2

