summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/documentation.tex33
1 files changed, 20 insertions, 13 deletions
diff --git a/doc/documentation.tex b/doc/documentation.tex
index d45de73..b4aeb78 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -191,29 +191,36 @@ umount /dev/<name>1
sync
\end{verbatim}
-Afterwards the SD card can be inserted into the Raspberry Pi. To do initial
-configuration it should be connected to a screen via HDMI. Also a keyboard has
-to be connected via USB. A mouse is not required. Finally the Pi should be
-powered up by connecting a USB power supply to the corresponding USB power
-input of the Raspberry Pi. Text from the boot process should be displayed on
-the screen.
+Afterwards the SD card can be ejected. The installation is completed while the
+system configuration is not covered.
+
+\section{Configure Alpine Linux for soundbox}
+
+An Alpine Linux installation can be configured as a soundbox host with the
+steps explained in the given section.
+
+For this configuration the SD card with an Alpine Linux installation has to be
+inserted into the Raspberry Pi. Furthermore a keyboard, monitor and USB power
+supply has to be connected. A mouse is not required. As soon as the power
+supply is attached text from the boot process should be shown on the monitor.
+
+\subsection{Basic Alpine Linux setup}
After logging in with the username \texttt{root} and no password basic system
configuration on Alpine Linux can be done interactively with
\texttt{setup-alpine}. The Alpine Linux installation
guide\footnote{\href{https://wiki.alpinelinux.org/wiki/Installation}{https://wiki.alpinelinux.org/wiki/Installation}}
-contains further details. When a diskless installation is chosen the
-configuration changes have to be made persistent with the \texttt{lbu} command.
-Otherwise they will be lost on the next reboot.
+contains further details. A diskless installation should be chosen for
+soundbox. This makes sure that the operating system is running from random
+access memory (RAM) and thus the system can be powered off by just removing the
+power supply.
\begin{verbatim}
setup-alpine
-lbu commit -d
\end{verbatim}
-With this setup the Alpine Linux installation is completed.
-
-\section{Configure Alpine Linux for soundbox}
+These changes are only temporary until they are made persistent as described in
+section~\ref{lbu-persistence}.
\subsection{Package installation}