Install starkOS

Requirements

Get the image

Download the latest rootfs tarball with SysV, Runit, or S6.
- https://sourceforge.net/projects/stark-os/files/
- https://nc.abetech.es/index.php/s/gYYDqniSeWWYcHs (mirror)

Installation steps

1. 01

   Prepare the partition

   >_ BIOS system with MBR

   Create a partition to install starkOS on:

   # cfdisk
   # mkswap /dev/sda1
   # mkfs.ext4 -L StarkOS /dev/sda2

   Create a directory to mount the partition and mount it:

   # mkdir /mnt/starkos
   # mount /dev/sda2 /mnt/starkos

   >_ EFI system with GPT

   An EFI system requires an additional vfat partition for /boot/efi; create it first:

   # cfdisk
   # mkfs.vfat /dev/sda1
   # mkswap /dev/sda2
   # mkfs.ext4 -L StarkOS /dev/sda3

   Create the directories to mount /root and /boot/efi:

   # mkdir -pv /mnt/starkos/boot/efi
   # mount /dev/sda3 /mnt/starkos
   # mount /dev/sda1 /mnt/starkos/boot/efi
   # swapon /dev/sda2

2. 02

   Extract the starkOS image

   Extract the starkOS image into the mounted location:

   # tar xvJpf starkos-rootfs-<version>-x86_64.tar.xz -C /mnt/starkos

3. 03

   Enter chroot

   Chroot into the extracted starkOS image:

   # mount -v --bind /dev /mnt/starkos/dev
   # mount -vt devpts devpts /mnt/starkos/dev/pts -o gid=5,mode=620
   # mount -vt proc proc /mnt/starkos/proc
   # mount -vt sysfs sysfs /mnt/starkos/sys
   # mount -vt tmpfs tmpfs /mnt/starkos/run
   # mkdir -pv /mnt/starkos/$(readlink /mnt/starkos/dev/shm)
   # cp -L /etc/resolv.conf /mnt/starkos/etc/
   # chroot /mnt/starkos /bin/bash

4. 04

   Configure the system

   Set the hostname, timezone, clock, font, keymap, and daemon:

   # vim /etc/rc.conf

   Configure /etc/fstab:

   # vim /etc/fstab

   Set the timezone:

   # ln -sf /usr/share/zoneinfo/Region/City /etc/localtime

   Set the system clock:

   # hwclock --systohc

   Configure locales:

   # vim /etc/locales

   Uncomment the locales you need, then run:

   # genlocales

   Set the root password:

   # passwd

   Add a user:

   # useradd -m -G users,wheel,audio,video -s /bin/bash <your username>

   Set a password for your user:

   # passwd <your username>

5. 05

   Sync repositories and update

   Sync the repositories:

   # portsync -r

   Update the system:

   # stark sysup

6. 06

   Install the kernel

   # stark install linux

   Note: replace 'linux' with 'linux-lts' if you want to use the LTS version.

7. 07

   Configure the bootloader (GRUB)

   BIOS:

   # grub-install /dev/sdX
   # grub-mkconfig -o /boot/grub/grub.cfg

   Note: replace 'X' with the letter of your partition's disk.

   EFI:

   # stark install grub-efi
   # grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="starkos"
   # grub-mkconfig -o /boot/grub/grub.cfg

8. 08

   Exit and reboot

   Exit the chroot environment:

   # exit

   Unmount the starkOS partitions:

   # umount -R /mnt/starkos

   You can now reboot your machine; starkOS GNU/Linux should be bootable.

   # reboot

This guide covers both BIOS systems with MBR and EFI systems with GPT. Adjust the partitioning and bootloader commands to match your hardware configuration. For further support, check the starkOS Wiki.