web/install.md

There are two ways you can install joborun quickly

1 From and Arch based system using pacman

2 By downloading our tarball of the minimal base system

the following is a draft and needs additions/corrections

1 First create a new partition for the system to be created. If you don't know how, see the great https://wiki.archlinux.org/title/Installation_guide#Partition_the_disks wiki on the subject. We will only provide here information that is different than Arch Linux or Obarun.

% wget https://git.disroot.org/joborun-pkg/jobcore/raw/branch/main/pacman/pacman.conf

This will get you a copy of joborun's pacman.conf file.

For simplicity we will refer to this prepared and mounted partition as the "target" /mnt and the arch system from which you will make the installation will be the "host" /

For EFI systems also follow the arch wiki EFI system partition and the obarun wiki entry uefi

Assumptions for this installation:

• User has partitioned, formatted, and mounted partitions on /mnt
• Network is functional
• Arguments passed to the script are valid pacman targets
• A valid mirror appears in /etc/pacman.d/mirrorlist
• You are in a root shell
• arch-install-scripts is installed in your system (includes arch-chroot & genfstab which will be used here)

One of the key differences with Arch is that joborun and Obarun have a few more repositories that are placed higher up in hierarchy within /etc/pacman.conf to give priority to joborun's packages over Obarun, and Obarun's in turn over arch.

Create pacman lib directory in /mnt

# mkdir -p /mnt/var/lib/pacman

This is necessary for installing pacman to the target in order to use the current and correct joborun pacman.conf.

install joborun's pacman to target

# pacman -Sy pacman base linux(***) --config ./pacman.conf -r /mnt

*** You have a choice of joborun's special linux-lts (5.10) or linux (5.15) and if you need linux/linux-lts headers add them to the list. Same for linux-firmware, especially if you have an AMD machine with Radeon gfx card, you will not get anything on screen without it.

We highly recommend linux-lts (5.10) as a very well developed kernel expiring in 2026, while 5.15 is expected to last only till 2024. So 5.10 is a longer LTS, while 5.15 is a relative short term LTS.

If you want additional packages you can either do this later through chroot or add them at the end of the above command (ie networking package of choice, text editor, arch-install-scripts, bootloader-grub/syslinux, etc. )

Select the closest mirrors to your location and remove the comment sign '#' from in front of them. Pacman hits the first uncommented server on the list and only if it fails goes to the next. You do this by editing: /etc/pacman.d/mirrorlist. This is a screened list from Arch to only include https:// mirrors, so some countries' mirrors that only offer an http:// servuce they have been ommitted.

# $EDITOR /mnt/etc/pacman.d/mirrorlist

Initialize pacman, re-populate its gpg-keys and update the database

# arch-chroot /mnt pacman-key --init
# arch-chroot /mnt pacman-key --populate joborun archlinux obarun
# arch-chroot /mnt pacman -Sy

Select the lingual group of your installation by removing the '#' (uncommenting - example: "en_US.UTF-8 UTF-8" for US English ) and pass the choice into the system:

# $EDITOR /mnt/etc/locale.gen

# arch-chroot /mnt locale-gen

Create an fstab entry of your new installation:

# genfstab -U /mnt >>/mnt/etc/fstab

Create a root password

# arch-chroot /mnt passwd

edit your hosts as per your network needs

# $EDITOR /mnt/etc/hosts

edit your hostname, although it should also be set by configuring your boot module

# $EDITOR /mnt/etc/hostname

7 Misc. optional configurations

Install and set your boot loader as per Obarun and/or arch wikis if necessary:

grub syslinux UEFI

#Note

Your installation is complete

You may either reboot at this point or use arch-chroot to get into the installation and do more configurations or pkg installations as you need.

Welcome to joborun

Note: In general, the hierarchy as seen in pacman.conf works in reverse for wiki. What you can not find here you may find in Obarun, as it applies here as well. What you can't find in Obarun wiki you can find in wiki.archlinux.org, and it applies for Obarun, and applies here as well. With the exception of anything that relates to systemd/logind. On the other side of the coin though there may be a tendency to overbrowse Artix wiki, and with the very specific runit similarity there is nothing that should be relevant, compatible, and non-destructive. As this distro is oriented to medium/advanced users do not expect much hand-holding especially with functionality of guis and desktops.