CLI installation instructions

This commit is contained in:
Out Of Ideas 2024-01-28 15:14:49 -06:00
parent 06eb7ca84c
commit db93f72e09

105
README.md
View file

@ -443,6 +443,11 @@ Now unpack it.
tar xvf void-*-ROOTFS*.tar.xz -C /mnt
```
Make sure you only download one ROOTFS tarball, or the wildcard will select more than one.
### Setting the XBPS mirror
Set the XBPS mirror.
```
xmirror -r /mnt -s $REPO
```
### Changing Root
To change root, you can use `xchroot` in the CLI installation. I tried to use `xchroot` after installing using the GUI meathod, and it did not work.
@ -450,12 +455,6 @@ Chroot into the sytem.
```sh
xchroot /mnt /bin/bash
```
### Setting the XBPS mirror
Set the XBPS mirror.
```
xmirror -r /mnt -s $REPO
```
Replace **\<mirror\>** with the mirror (ie. `https://mirrors.servercentral.com/voidlinux`).
### Updating System
If you followed the XBPS meathod, skip this section.
@ -484,14 +483,102 @@ Now set the timezone.
```sh
ln -sf /usr/share/zoneinfo/<region>/<timezone> /etc/localtime
```
Replace **\<region\>** with the region found in the output of `ls /usr/share/zoneinfo`, and **\<timezone\>** with timezone found in the output of `ls /usr/share/zoneinfo/<region>`, where of course **\<region\>** was replaced with the region found in the output of `ls /usr/share/zoneinfo`.
Replace **\<region\>** with the region found in the output of `ls /usr/share/zoneinfo`, and **\<timezone\>** with timezone found in the output of `ls /usr/share/zoneinfo/<region>`, where of course **\<region\>** was replaced with the region found in the output of `ls /usr/share/zoneinfo`. (ie. `America`; `Chicago`).
### Installing a Terminal Text Editor
Install a terminal text editor of choice
```sh
xbps-install -S vis
```
### Editing `/etc/rc.conf`
The keymaps are listed in `/usr/share/kbd/keymaps`. If you are using a different keymap, then replace `dvorak` with that keymap. The keymap will be changed back to Grandma's keymap later.
### Setting he keyboard layout
Edit `/etc/rc.conf`.
```
vis /etc/rc.conf
```
Replace this
```
# Keymap to load, see loadkeys(8).
#KEYMAP="es"
```
with this
```
# Keymap to load, see loadkeys(8).
KEYMAP="<keyboard layout>"
```
where **\<keyboard layout\>** is replaced with the keyboard layout that you use (ie. `dvorak`). The keyboard layouts are listed in `/usr/share/kbd/keymaps`. The keyboard layout will be changed back to Grandma's keymap later.
```
ls /usr/share/kbd/keymaps/i386/
```
### Setting the Locale
Edit `/etc/default/libc-locales`.
```
vis /etc/default/libc-locales
```
Uncomment the desired locales (remove the `#` at the beginning of the line).
```
en_US.UTF-8 UTF-8
```
Now reconfigure the locales.
```
xbps-reconfigure -f glibc-locales
```
### Setting the Root Password
Set the root password.
```
passwd
New password:
Retype new password:
```
Make it strong.
### Configuring fstab
Generate `/etc/fstab`.
```
cp /proc/mounts /etc/fstab
echo "$(grep -v proc /etc/fstab | grep -v sys | grep -v devtmpfs | grep -v pts)" > /etc/fstab
echo "<swap partition> swap swap rw,noatime,discard 0 0" >> /etc/fstab
```
Replace **\<swap partition\>** with the swap partition (ie. `/dev/sda2`).
Now run `blkid` to see the UUID of each partition.
```
blkid | sed 's/"//g'
```
Replace `/dev/*` (all refrences to a partition) with their UUID.
```
UUID=66dfcdb5-0ec7-4c90-8e3a-7f13cc65698d / xfs rw,relatime,attr2,inode64,logbufs=8,logbsize=32k,noquota 0 0
UUID=E8F6-20BF /boot/efi vfat rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=iso8859-1,shortname=mixed,utf8,errors=remount-ro 0 0
tmpfs /dev/shm tmpfs rw,nosuid,nodev,noexec,inode64 0 0
LiveOS_rootfs /etc/resolv.conf overlay rw,relatime,lowerdir=/run/rootfsbase,upperdir=/run/overlayfs,workdir=/run/ovlwork 0 0
UUID=de4a6878-d346-4f66-9a38-78bcbe4866c9 swap swap rw,noatime,discard 0 0
```
### Installing a Bootloader
Follow the directions for Grub, EFI stub, or LILO.
#### Grub
If you have issues, please refer to the [official docummentation](https://docs.voidlinux.org/installation/guides/chroot.html#troubleshooting-grub-installation).
##### UEFI
Install Grub
```
xbps-install grub-x86_64-efi
grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="Void"
```
##### Legacy BIOS
Install Grub
```
xbps-install grub
grub-install <disk to install to>
```
Replace **\<disk to install to\>** with the disk that the system wis installed to.
### Reconfiguring
Reconfigure for good measure
```
xbps-reconfigure -fa
```
### Rebooting
Exit, unmount, and reboot.
```
exit
umount -R /mnt
shutdown -r now
```
## GUI
### Running the installer
Running the installer is simple.