aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--SETUP.md104
1 files 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.