web/inst_from_image.md

5.9 KiB

Back to the top joborun wiki page

..continued from installation section 1.

2 Installation using a joborun image and checksum .

Currently (alpha phase) we only have a tarball of a system which would need at least a kernel and a bootloader to boot. In the near feature (during the beta period) we will provide a bootable image.

a Again, as usual, you must first prepare a clean partition of at least 2GiB for a base system 3GiB for one with basic graphic functionality, X + Openbox/JWM etc. If you are unsure of this process follow the wiki from Arch on the first steps of installation.

b Mount the partition in a proper mounting point, for our instructions we will use /mnt but if this is used create a mounting point and replace /mnt wherever it appears in the instructions.

c Download our latest tarball image from this page: https://joborun.neocities.org/download.html

d Download the one line txt file that states the ckecksum and check the image into someplace like /tmp.

sha256sum jobo.alpha*.tar.xz
cat jobo.alpha*.tar.xz.sum 

The output of both should be the same, if not try to download again and let us know as soon as possible of the discrepancy.

cd /mnt
sudo tar -xf /tmp/jobo.alpha*tar.xz 
ls -al 

The output of ls -al should give you what appears as the root directory of a common linux system.

You can now chroot into the system

sudo arch-chroot /mnt zsh

The /etc/locale.gen is set to UTF8 US-en, change it to the valid choice of preference, and then run locale-gen to pass the new setting to the system. Even if you stay with US-en, run locale-gen anyway. We have some shortcut/scripts saved in /usr/local/bin/, it is a good time to get to know them, as well as a few shortcuts saved in .zshrc (our default shell). uuid will give you the list of partitions, their labels, and /dev/ addresses. Run it before you prepare the fstab to make sure it is correct. We like minimal easy to understand scripts that make work a little easier.

As root

genfstab -U / | grep -v resolv >>/etc/fstab

Since you are on chroot the mounted /etc/resolv.conf from the host will be invalid once you boot the system, hence the exclusion of that line/entry.

Next set the password for root and user make, or add a new user if you like, but make sure you look at some helper scripts saved in /home/make that will make the installation of openbox/jwm easier, as well as make s6/66 univentful.

passwd 
passwd make

With the script called add.66 which will install all necessary packages to boot the system with s6/66 already setup for you. You will only need to run 66 tools to modify the setup. We have provided a pre-configured setup to match the one of runit so you can compare.

There is also installX (% ./installX) which will install everything we deemed necessary for a minimal window manager experience and our initial setup, expecially for openbox. Jwm may need some attention still. Before you run the script, see that it reads a list of packages named X.list, from which you can subtract what you know you don't need and add what you know you will like and it is available by the 3 different distributions in effect here (joborun obarun archlinux).

If you are running this from console and you left xinit inside the script it will attempt to take you to openbox as soon as the installation finishes. If you are running from an X-terminal then since X is already running it will fail, so you may as well comment it out.

Finally, before reboot you need a kernel and a bootloader. Assuming you are an advanced user and know how to configure grub and/or syslinux (otherwise see the obarun and archlinux wikis) choose your kernel. Our kernels are linux-lts (5.10) and linux (5.15) which is the current lts for Arch. Our kernels have been modified to turn off internal zstd use, and ipv6, as we do in most packages we can. It also has the touchscreen firmware left out of the kernel to reduce the size a tiny bit. Obarun also offers a couple of kernel sets although they tend to be outdated. Otherwise you are on your own, but for the two kernels we carry we make it easy for the user to build on their own, and if one doesn't agree with our choices they can revert them or use the ArchLinux config which is also stored in our git. (on building packages see the howto section of our wiki).

If you are familiar with runit we have set up a basic set of ttys dhclient and wpa_supplicant for network, ntpd for time server, and have a wide set or runscripts ready to activate as you need in /etc/runit/sv Do not activate them though as they most likely need the software the service corresponds to, except for dbus which is a core dependency of the base system. Dbus is not running by default, you have to make this choice for yourself. You CAN live without it if you like.

Same exact minimalism is setup for 66. Those scripts saved in /home/make are to make a tidious taks easier and complete. They don't have to be used and each can be used in the future.

$ pkg -Sy linux-lts grub
$ sudo grub-mkconfig -o /boot/grub/grub.config
$ sudo grub-install /dev/sda

Will get you our linux-lts hernel (add headers if you know you need them) and install the bootloader. Add os-prober if you want to take a chance and allow os-prober to setup multiboot for you. For grub choices edit /etc/default/grub accordingly.

Reboot!

For our choice of Openbox and JWM setup there is a script in /home/make that installs what is needed in one run. At the end openbox starts by default and you can switch this behavior to jwm simply by commenting/uncommenting the two exec lines of ~/.xinitrc.