| chtc | OUTDATED | 2022-03-12 | void linux propaganda |

Table Of Contents

  1. Introduction
  2. The install process
  3. xbps-src
  4. xtools
  5. Creating your own ISO
  6. Neat Void only software

§ Introduction

Void Linux is a rolling release Linux distribution focused on stability.

It isn't based on another distro (like Arch for example), it uses it's own package manager, XBPS (X Binary Package System), the runit init system (which was modified a little bit) and supports both glibc and musl.

I recommend using the Void Handbook for Void related stuff, it will probably help you and if it doesn't well then you could ask for help on the #voidlinux IRC channel on libera.chat or on the subreddit.

If you want to look at the source code of Void related things then take a look at their GitHub account.

They also have a Twitter account which you could follow for news (and a BLM tweet once in a century) or you could just use their website (rss feed).

§ The install process

Installing Void isn't complicated (there are some exceptions that I'm gonna talk about later).

You download a live image, create a bootable media of your choice, then once you are inside the live image, you login and just go through the installer.

The scariest thing in the install process is probably partitioning your disks but even that isn't crazy.

And the post-install process (for the base image) is as complicated as you want it to be.

Now for a few things you need to install Void via chroot:

§ xbps-src

If something really isn't in the repos, I suggest you first check if it's in the Void packages git repository (for example something like Discord).

Why? Because it has a thing called xbps-src and some packages that don't have binaries in the repos.

I'm not gonna write a xbps-src tutorial here, all the info you need is in the Void packages repo but I'm gonna tell you one thing, when cloning the repository use:

git clone --depth 1 https://github.com/void-linux/void-packages

because when you don't, you will be waiting longer and more of your precious space will be taken.

You can also use xbps-src to change a compile flag or to apply a patch without having to remove the files of the version from the repo because some other package depends on the one you are changing. You just need to run xbps-pkgdb -m repolock <package name> so it doesn't replace the package on update.

Want something in the repos? Well you could ask for someone to create a package for it or you could create it yourself and submit a pull request to the Void packages repo. (You will also need to pray and hope that it gets accepted)

Or maybe some package is outdated, you can also update it and submit a pull request. Sometimes it will be as straightforward as just changing the version and checksum but sometimes you will maybe need to change some other stuff in the template. It's amazing that literally everyone can contribute to the Void repos that effortlessly!

Other people have their own git repositories with xbps-src template for various package, here are a few that I found on the internet:

You can also check out my own Void packages repo. I doubt the templates are of the highest quality but I got some nice stuff in there. And also I'm lazy and don't bother with doing a PR to the repo.

§ xtools

Maybe you are tired of adding --repository every time you are installing something from xbps-src. Now instead of just making an alias I recommend installing xtools and using the xi command.

Why? Because xtools has some cool stuff which can help you with xbps-src related stuff but also other commands that will help you with everyday life.

For example:

The xi, xls, xq and xrs will use the hostdir/binpkgs repo if you run them from a void-packages checkout.

§ Creating your own ISO

Now this isn't anything new, like archiso (for Arch) exists but I'm gonna mention it anyway.

You can create custom Void Linux ISOs with void-mklive, you can add packages to it, add files to it, change some stuff like the keymap and locale, maybe you want to create a minimal ISO and use base-minimal instead of base-system.

Probably everything you need is in these scripts. And you can always edit them if you need something more to be done (sadly I don't know how much knowledge you need).

I recommend using the build-x86-images.sh script so the live image works like it should, oh and you can also build Void ISOs for some other DE's like MATE, GNOME and KDE etc if you need that (as of writing Void only has the XFCE ISO). Or you could plop down those packages into your package list in mklive.sh, the choice is yours.

There is a site that provides custom Void ISOs with these DEs and more (there is even an i3 ISO) with also some additional packages.

I actually create my own ISO (based on this repository) with GitHub actions, it basically has the packages I use, my dotfiles and some system settings.

§ Neat Void only software

This is a list of some nice Void only software that could come in handy.

I personally don't use any of them except for xdeb (which I don't even use often).

I have already mentioned xtools and xbps-src.