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 | 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 als follow the arch wiki [[https://wiki.archlinux.org/index.php/EFI_system_partition|EFI system partition]] and the obarun wiki entry [[https://wiki.obarun.org/doku.php?id=uefi|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 and pacstrap)

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 in turn over arch.

######  Create pacman lib directory in /mnt ######

<pre>
# mkdir -p /mnt/var/lib/pacman
</pre>

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 ######


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

***  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.  

<pre>
# $EDITOR /mnt/etc/pacman.d/mirrorlist
</pre>

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

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

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:

<pre>
# $EDITOR /mnt/etc/locale.gen
</pre>

<pre>
# arch-chroot /mnt locale-gen
</pre>

Create an fstab entry of your new installation:

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

Create a root password

<pre>
# arch-chroot /mnt passwd
</pre>

edit your hosts as per your network needs 

<pre>
# $EDITOR /mnt/etc/hosts
</pre>

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

<pre>
# $EDITOR /mnt/etc/hostname
</pre>


###### 7 Misc. optional configurations ######

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

[[grub|grub]]  [[syslinux|syslinux]]


###### 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**

###### Don't forget ######

If the host system is not a live system but a regular installation, you must copy back the original pacman.conf from its temporary saved location

<html><pre>
# cp -a /etc/pacman.conf.arch /etc/pacman.conf
</pre></html>