From aa8322e9dd1d7fbd7342fecb7cd3b1928dbad9f6 Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Sun, 26 Jul 2020 11:40:38 +0200
Subject: borrow heavily from USE text of box.redpill.dk

---
 SETUP.md | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 97 insertions(+), 7 deletions(-)

diff --git a/SETUP.md b/SETUP.md
index a353b68..7a689d1 100644
--- a/SETUP.md
+++ b/SETUP.md
@@ -42,7 +42,7 @@ or (if acceptable to you) include suitable nonfree drivers.
   "List of Debian-compatible wifi chipsets"
 
 
-## Install core system
+## Install system
 
 You are generally recommended to install a stable system.
 Alternatively you can install a testing system -
@@ -59,6 +59,9 @@ while the computer is **turned off**
 (also use a strong user password and a screensaver with locking).
 Also, if you forget your disk password then **all your data is lost!**
 
+
+### Download image
+
 Download newest [Lime2 image] or [Teres-I image]
 (or pick another among [all available images]).
 
@@ -69,11 +72,6 @@ with the regular box image
 If including nonfree code is acceptable to you
 then you can instead use a [nonfree box image].
 
-Follow the guide at <http://box.redpill.dk/#store-image>
-to copy the image over to an install medium,
-and then start the new system, enable network,
-and finalize system setup.
-
 [Lime2 image]: <images/core/core-lime2-buster.img.gz>
   "Debian system image tailored for Olimex OLinuXino lime2 box"
 
@@ -87,7 +85,99 @@ and finalize system setup.
   "Pre-installed 'box' images with nonfree firmware"
 
 
-## Setup desktop
+### Store image
+
+You need to transfer the downloaded image onto your install device -
+i.e. overwrite the whole raw **disk** device
+(not a partition on the disk).
+
+**Beware:**
+Take great care not to accidentally overwrite the wrong disk device!
+
+First identify the **path** name of the install device
+by running a command repeatedly -
+with and without the install device plugged in -
+to notice which device changes in the output of the command.
+
+**Linux:**
+Try this command:
+
+    lsblk --paths
+
+**MacOS:**
+Try this command:
+
+    ls /dev/rdisk?
+
+The path is listed in the first column -
+something like `/dev/sdf` or `/dev/rdisk7`.
+
+Check also that the disk is not mounted,
+on linux shown in last column of output of above command.
+If the device disk has anything mounted
+then **unmount** it before preceeding.
+
+Decompress and copy image onto card
+(adjust image name and device path as needed):
+
+    gunzip core-lime2-buster.img.gz
+    sudo cp core-lime2-buster.img PATH_TO_YOUR_SDCARD
+
+
+### Install core system
+
+Turn off the target computer,
+plug in the microSD card,
+turn on power,
+and log in.
+
+**Username:**
+debian
+
+**Password:**
+insecure
+
+
+### Setup network
+
+Check network access (status should ideally be _routable_):
+
+    networkctl status
+
+Optionally you can additionally test connectivity
+towards a common public host:
+
+    mtr --displaymode=1 1.1.1.1
+
+With **ethernet**
+(builtin or a USB dongle),
+just connect cable.
+
+With **wifi**,
+do something like this:
+
+    iwctl station wlan0 get-networks
+    iwctl station wlan0 connect SSID_LISTED_ABOVE
+
+If above fails with error message
+
+> Operation failed
+
+then try restart iwd:
+
+    sudo service iwd restart
+
+...and then repeat the `iwctl` commands.
+
+
+### Finalize core system
+
+Finalize setup of the system:
+
+    sudo system-setup
+
+
+### Install desktop environment
 
 You are recommended to use the Xfce desktop -
 as a conservative X11 desktop environment.
-- 
cgit v1.2.3