From 7966e87f609a809c8459bf49300454280b9f357a Mon Sep 17 00:00:00 2001
From: Elena ``of Valhalla'' Grandi <valhalla@trueelena.org>
Date: Wed, 10 Sep 2025 21:24:36 +0200
Subject: Start documentation on the TuxBox

---
 source/self_hosting/tuxbox/index.rst | 71 ++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 source/self_hosting/tuxbox/index.rst

(limited to 'source/self_hosting/tuxbox/index.rst')

diff --git a/source/self_hosting/tuxbox/index.rst b/source/self_hosting/tuxbox/index.rst
new file mode 100644
index 0000000..aa88d0c
--- /dev/null
+++ b/source/self_hosting/tuxbox/index.rst
@@ -0,0 +1,71 @@
+******
+TuxBox
+******
+
+This is my version of a local network content sharing box, inspired by
+the more famous PirateBox_; it is based on a plain Debian installation,
+on which services are installed and configured.
+
+.. _PirateBox: https://en.wikipedia.org/wiki/PirateBox
+
+.. only:: html
+
+   .. contents::
+
+Requirements
+============
+
+You need a Single Board Computer or another device with a Debian_
+installation; ideally a basic netinstall from the official installer,
+with at most the SSH server and standard system utilities tasks, plus
+any firmware required by your hardware.
+
+* `Debian concatenateable images for armhf
+  <https://deb.debian.org/debian/dists/trixie/main/installer-armhf/current/images/netboot/SD-card-images/>`_
+* `Debian concatenateable images for arm64
+  <https://deb.debian.org/debian/dists/trixie/main/installer-arm64/current/images/netboot/SD-card-images/>`_
+
+.. _Debian: https://www.debian.org/distrib/
+
+If not already on the board, you also need a wifi card capable of being
+configured as an Access Point.
+
+For storage, these instructions assume that the OS will be on an SD card
+(or other small device, such as an eMMC) and that data will be on an
+external hard disk mounted on ``/mnt/tuxbox``; if using the same hard
+disk for everything you may want to keep the data under ``/srv/tuxbox``
+or another suitable location.
+
+Configuration
+=============
+
+Network
+=======
+
+Configure your network interfaces 
+
+Access Point
+------------
+
+Install ``hostapd``, ``dnsmasq`` and some useful programs::
+
+   apt install hostapd dnsmasq iw
+
+Copy the ``hostapd`` example configuration::
+
+   cp /usr/share/doc/hostapd/examples/hostapd.conf /etc/hostapd/hostapd.conf
+
+and edit it as needed, changing at least the following values:
+
+* ``interface=``
+* ``ssid=``
+* ``country_code=``
+
+then unmask the systemd service::
+
+   systemctl unmask hostapd
+
+See also
+========
+
+
-- 
cgit v1.2.3