summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorxengineering <me@xengineering.eu>2024-01-30 20:26:00 +0100
committerxengineering <me@xengineering.eu>2024-01-30 20:26:00 +0100
commit718422591a603223ff64f7d056d4b2f986109530 (patch)
tree014b115a21934d2e8fac4c30dbffe27b8283f7d0 /doc
parent8c883f04f9c07d1a14a34daaac99250c0ae6b97e (diff)
downloadsoundbox-718422591a603223ff64f7d056d4b2f986109530.tar
soundbox-718422591a603223ff64f7d056d4b2f986109530.tar.zst
soundbox-718422591a603223ff64f7d056d4b2f986109530.zip
doc: Move 'setup-alpine' to configuration section
This was never part of an installation but instead of a configuration step.
Diffstat (limited to 'doc')
-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}