NAME

installation — installing rawnix from the netinstall image

DESCRIPTION

The rawnix netinstall image boots to a root shell. Nothing networked starts by itself: the network, and the clock, are brought up by hand, so each step says what it is doing. The packages are downloaded from rsync.rawnix.org during the install.

An install has these steps, in this order. Each has its own page:

1. Bring up the network; see network(7).
2. Partition the disk, make the file systems and mount them under /mnt; see partition(7), or for an encrypted system encryption(7).
3. Mount the EFI system partition at /mnt/boot/efi.
4. Create the file system skeleton:
   # setup-filesystem /mnt
   See setup-filesystem(8).
5. Write the kernel command line:
   # setup-boot /mnt
   See setup-boot(8).
6. Install the packages:
   # install --target /mnt base
   See install(8) for the groups.
7. Write the file system table and enter the new system:

   # genfstab /mnt > /mnt/etc/fstab
   # enter-chroot /mnt

   See genfstab(8) and enter-chroot(8).

8. Inside the new system, set the essentials:

   # passwd root
   # echo myhostname > /etc/hostname
   # ln -sf /usr/share/zoneinfo/Region/City /etc/localtime
   # ports -u

   Run ports -u before any pkg(8) command: pkg sets up its dependency database the first time it runs, and needs the ports tree for that.

9. Check the boot setup before rebooting; see bootloader(7).

The order matters in two places. setup-boot must run before the kernel is installed, and the EFI system partition must be mounted by then: installing the kernel runs limine-sync, which writes the boot menu from what setup-boot wrote.

setup-help prints a one-screen summary of the same steps.

EXAMPLES

A whole unencrypted install on /dev/sda, wired network:

# dhcpcd eth0
# fdisk /dev/sda
# mkfs.fat -F32 /dev/sda1
# mkfs.ext4 /dev/sda2
# mount /dev/sda2 /mnt
# mkdir -p /mnt/boot/efi && mount /dev/sda1 /mnt/boot/efi
# setup-filesystem /mnt
# setup-boot /mnt
# install --target /mnt base
# genfstab /mnt > /mnt/etc/fstab
# enter-chroot /mnt

SEE ALSO

bootloader(7), encryption(7), network(7), partition(7), enter-chroot(8), genfstab(8), genluks(8), install(8), setup-boot(8), setup-filesystem(8)