web/install.md

### [[Back to the top joborun wiki page|index.md]] ###


## There are two ways you can install joborun quickly ##

#### [[1|install.md]]     From an Arch based system using pacman ####
#### [[2|inst_from_image.md]]    By downloading our [[tarball|inst_from_image.md]] of the minimal base system ####


1    First create a new partition for the system to be created.  If you don't know how, see the great [[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.

<pre>
% cd /tmp
% wget https://git.disroot.org/joborun-pkg/jobcore/raw/branch/main/pacman/pacman.conf</pre>

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

###### Assumptions for this installation: ######

  -   User has partitioned, formatted, and mounted partitions <bold>on /mnt</bold>
  -   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 packages over arch.  (Obarun's packages other than s6/66 are generally rebuilds without systemd/libs running dependencies.  Joborun's packages over Arch are rebuilds without systemd/libs makedependencies).

######  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 /tmp/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. ).
We are trying to make sure you have a fully functional system to boot and login to console, then you can install whatever you like.

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:// service have been ommitted.  You can always replace our pacman-mirrorlist pkg with core/pacman-mirrorlist by:  pacman -S core/pacman-mirrorlist which includes the http: only sites.

<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 -Syu
</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>

If you are working in chroot don't expect the change in locale to be automatic, you must either restart a shell, or exit and re-enter, or in a booted system relogin.  By reboot it will for sure change the language.

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 Obarun and/or arch wikis if necessary:

[[grub|https://wiki.obarun.org/doku.php?id=grub]]  [[syslinux|https://wiki.obarun.org/doku.php?id=syslinux]] [[UEFI|https://wiki.obarun.org/doku.php?id=uefi]]    

[[#Note|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.