diff options
Diffstat (limited to 'tutorial.md')
| -rw-r--r-- | tutorial.md | 40 |
1 files changed, 26 insertions, 14 deletions
diff --git a/tutorial.md b/tutorial.md index c8e48e0..53171f1 100644 --- a/tutorial.md +++ b/tutorial.md @@ -8,14 +8,13 @@ You need: The steps: -1. Download the installer image from - <https://files.liw.fi/v-i/v-i.img.xz>. You can use `curl` or `wget` - or your web browser. Use **one of** the following commands: - - ~~~sh - curl https://files.liw.fi/v-i/v-i.img.xz > v-i.img.xz - wget -c https://files.liw.fi/v-i/v-i.img.xz - ~~~ +1. Download the installer image (`v-i.img.xz`) and related scripts + (`configure-installer` and `write-and-config.sh`) from a + subdirectory or <https://files.liw.fi/v-i/>. + + * <https://files.liw.fi/v-i/VERSION/v-i.img.xz> + * <https://files.liw.fi/v-i/VERSION/configure-installer> + * <https://files.liw.fi/v-i/VERSION/write-and-config.sh> 2. Unpack the downloaded image. @@ -40,6 +39,14 @@ The steps: to log in as `root` using SSH. Password logins are not allowed for SSH. You can also log in via the console, as `root`, without a password. + + The installer configuration file can specify a wifi access point to + connect to, if you need that. + + ~~~yaml + wifi_name: DadItIsThisOne + wifi_password: hunter2 + ~~~ 4. Insert USB drive and find out the device allocated it. I prefer GNOME Disks for this, but you can also look up the device of the USB @@ -49,7 +56,7 @@ The steps: 5. Write the installer image to the USB drive, and configure it. ~~~sh - sudo ./write-and-config.sh config.yaml /dev/sdx v-i.img + sudo bash write-and-config.sh config.yaml /dev/sdx v-i.img ~~~ This will take a few minutes. @@ -58,8 +65,7 @@ The steps: prefer GNOME Disks for this, but from the command line: ~~~sh - sync - eject /dev/sdx + udisksctl power-off -b /dev/sdx ~~~ 7. Move the USB drive to the target machine and boot off the drive. @@ -75,7 +81,7 @@ The steps: ~~~sh iwctl station wlan0 get-networks - iwctl stations wlan0 connect DadItIsThisOne + iwctl station wlan0 connect DadItIsThisOne ~~~ Substitute the name of the network as needed. Enter wifi password @@ -87,11 +93,17 @@ The steps: will be encrypted using LUKS, with the password "hunter2". ~~~yaml + hostname: x220 drive: /dev/nvme0n1 luks: hunter2 + ansible_vars: + user_pub: | + ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPQe6lsTapAxiwhhEeE/ixuK+5N8esCsMWoekQqjtxjP ~~~ - See [spec.md][] for a full description of the specification file. + The SSH public key will be added to the root user's + `authorized_keys` file. See [spec.md][] for a full description of + the target specification file. 10. Install. Add the `--verbose` option to `./v-i` if you want to know what's happening. The first time you run this on a given v-i USB @@ -115,5 +127,5 @@ The steps: 13. Optional: Let me know how it went. -[spec.md]: spec.md +[spec.md]: spec.html |