diff options
| -rw-r--r-- | SETUP.md | 104 |
1 files changed, 97 insertions, 7 deletions
@@ -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. |