Hello! In this article, I’ll show you how to install Void Linux on a UEFI + GPT system and build a minimal environment.

Have you ever heard of Void Linux? Compared to distributions such as Ubuntu, openSUSE, and Fedora, Void Linux is less well known and may seem a bit intimidating at first. In this guide, I’ll walk through installing Void Linux and setting up a minimal system without a graphical desktop environment.

What Is Void Linux?

Void Linux is a Linux distribution that allows you to build your system from a minimal installation, much like Arch Linux or Gentoo Linux, customizing it to suit your own preferences and needs.

Unlike Arch Linux, however, Void Linux doesn’t force you to start from a completely command-line environment. Installation media with the Xfce desktop environment are also available, making it somewhat more approachable for beginners.

That said, Japanese users may encounter an additional hurdle: localization. If you’re accustomed to distributions like Ubuntu or Fedora, which can be installed in Japanese and provide Japanese input immediately after installation, Void Linux may come as a bit of a surprise.

Void Linux uses the XBPS package manager instead of APT or DNF, so users coming from Debian- or Fedora-based distributions may notice some differences in package management. It also uses runit as its service manager, which may feel unfamiliar if you’re used to systemd or OpenRC.

Although Void Linux sits somewhat outside the mainstream Linux ecosystem, it’s an interesting distribution to explore. Personally, using it reminded me of the excitement I felt when I first tried Arch Linux.

Installing Void Linux Isn’t as Difficult as You Might Think

If you’re interested in Void Linux, you may also think that installing it looks difficult.

While it’s true that Void Linux doesn’t include a polished graphical installer like Ubuntu or Fedora, it does provide a TUI (text-based) installer. As a result, installation is considerably easier than distributions such as Arch Linux or Gentoo Linux, where everything is performed manually from the command line.

The installer is available only in English, so users who aren’t comfortable with English may find it slightly challenging. However, since the installation process mainly consists of answering the installer’s prompts, anyone with a basic understanding of disk partitioning should have little trouble completing it.

Downloading the Installation Media

Download the installation image from the official download page.

https://voidlinux.org/download/

For this guide, we’ll use the base edition to build a minimal environment.

If you’d like to create a bootable USB drive by writing the ISO image directly to a USB flash drive, use the following command.

dd bs=4M if=/path/to/isofile of=/dev/sdX status=progress && sync

Booting the Installation Media

When booting the installation media in UEFI mode, GRUB appears as shown below.

GRUB Screen

GRUB screen

Once the installation media has booted successfully, you’ll be prompted to log in.

Use the following credentials.

Username Password
root voidlinux

Launching void-installer

The installation media includes a TUI installer called void-installer.

By following the installer’s prompts, you can complete the installation smoothly.

Launch it with:

void-installer

The installer will start as shown below. Follow the menu to proceed with the installation.

Installer Startup Screen

Installer startup screen

Installer Menu

Installer menu

Keyboard Layout

First, configure the keyboard layout.

For this example, select jp106.

Keyboard Layout Configuration

Keyboard layout configuration

Network

It’s recommended to perform the installation while connected via a wired Ethernet connection.

In this guide, we’ll configure the network using DHCP. If you’d rather use a static IP address, enter the appropriate network settings instead.

Network Configuration

Network configuration

DHCP Configuration

DHCP configuration

Selecting the Installation Source

Next, choose the package source for the installation.

If you want the latest packages, select Network. If you prefer a faster installation, choose Local.

If you’re installing from the Xfce edition and intend to use the bundled Xfce desktop environment, be sure to select Local.

Installation Source

Installation source

Hostname

Choose a hostname for your computer.

In this example, we’ll use void.

Hostname Configuration

Hostname configuration

Locale

Since our goal is to build a minimal console-based environment, select en_US.UTF-8 as the locale.

Locale Configuration

Locale configuration

Time Zone

For this guide, select Asia/Tokyo.

If you live in Japan, this is the appropriate setting.

Time Zone Configuration

Time zone configuration

Root Password

Set a password for the root account.

Root Password Configuration

Root password configuration

Creating a User Account

Next, create a user account with administrative privileges.

Username

Username

User Password Configuration

User password configuration

Add this user to the wheel group if you want to use the sudo command.

Group Configuration

Group configuration

Bootloader

Select the device on which to install the bootloader.

On UEFI systems, choose the device that contains the EFI System Partition (ESP).

If another bootloader is already installed and can boot Void Linux, simply select none.

Bootloader Configuration

Bootloader configuration

Partitioning

Within void-installer, you can choose either fdisk or cfdisk for partitioning.

Use whichever tool you prefer.

You can also launch either tool before starting the installer if you’d rather partition the disk in advance.

For more information about Linux partitioning tools, see:

Comparing Partition Management Tools for Linux

First, select the target storage device.

Device Selection

Device selection

Next, choose the partitioning tool.

Partitioning Tool Selection

Partitioning tool selection

For this guide, we’ll use the following partition layout.

Device Mount Point Filesystem Type
sda1 /boot FAT32 ESP (EFI System Partition)
sda2 / ext4 Linux filesystem
sda3 - swap Linux swap

Configuring the Filesystems

Next, configure the filesystems.

Assign the filesystems and mount points according to the partition layout shown above.

Partition Selection

Partition selection

Mount Point Selection

Mount point selection

Starting the Installation

Once all settings have been configured, you’re ready to begin the installation.

The installer will ask for confirmation before proceeding. Select “Yes” to start the installation.

Installation Confirmation

Confirmation before installation

Rebooting and Logging In

When the installation completes successfully, you’ll be asked whether you want to reboot the system.

Select “Yes” to restart your computer.

After rebooting, GRUB2 will start and boot into your newly installed Void Linux system.

Log in using the user account you created during the installation.

Reboot

Reboot

Conclusion

Congratulations! You’ve successfully installed Void Linux.

How did the installation process go? It was probably easier than you expected.

At this point, only the base packages are installed, and no display server or desktop environment has been configured yet. As a result, graphical applications are not available.

The official Void Linux documentation contains a wealth of information on configuring and customizing your system for everyday use.

https://docs.voidlinux.org/

Although it isn’t as comprehensive as the ArchWiki, it provides plenty of useful guidance. Exploring the documentation and building your own personalized environment is part of what makes Void Linux so enjoyable.

I also plan to continue publishing more articles about setting up and customizing Void Linux here on this blog.

Thank you for reading, and I hope you’ll look forward to future articles!