Warning: THE VOID WIKI IS DEPRECATED. It is no longer being maintained, contains outdated and incorrect information, and will eventually be shut down. Please refer to the Void Handbook, https://docs.voidlinux.org/, for the official documentation. If you can't find the information you're seeking, please raise an issue at https://github.com/void-linux/void-docs/issues


From Void Linux Wiki
Revision as of 04:40, 19 January 2019 by Lantlos (talk | contribs) (→‎Network)
Jump to navigation Jump to search

This entry attempts to walk through the basic steps required to perform a minimal Void Linux installation via a Void live image . It does not attempt to go into fine detail for every step but additional documentation may be found linked throughout this document, as well as via man pages, additional resources in the Guides section etc.

If you are installing on a UEFI system, and wish to do so in UEFI mode, then you should have a look at the Installation: UEFI page, which follows this walkthrough, but includes notes that are specific to UEFI installation. Additionally, it contains a troubleshooting section for issues specific to UEFI setup.

Getting Started

Download the Void live image ISO from https://repo.voidlinux.eu/live/current/ and create an installation medium.

For further information regarding the live images and system requirements, see Live Images.


Boot your machine using the previously-created installation medium. You can choose to run the live image from the media, or, if you have the resources available, you can load the contents of the image into RAM. This option takes some time at the beginning but provides a quicker-overall installation procedure.

Once the live image has booted to a login prompt, log in as root using password voidlinux and then run:

# void-installer


Select the keymap for your keyboard; standard "qwerty" keyboards will generally use the "us" keymap.


Select your primary network interface. If you use DHCP on your network, select that option, otherwise the installer will prompt for IP Address, Netmask, and Gateway.

If you intend to use a wireless connection during the installation, you might have to configure it manually using wpa_supplicant and dhcpcd before running void-installer. Simply follow the instructions given here.


Choose whether you want to install from a local source (the packages that are included in the ISO) or from the network (in which case packages are downloaded from the Void remote repositories). Installing from the network allows you to install the most up-to-date packages available from the official repositories. Note that installing from local will also install any desktop included in the ISO (eg xfce)


Set a hostname for your computer remembering that hostnames should be all lower case, with no spaces.


Configure your default locale settings, this will be used to set the libc locale in a glibc environment.

The locale setting does not currently respond with the musl installer. Locales are not currently supported natively in musl. Workarounds with varying effectiveness are discussed in the forum.


Set your timezone based on standard timezone options.

Root Password

Enter and confirm the password used for the root account on your new Void installation. The password will not be shown on screen.

User Account

Choose a login (default void) and a descriptive name for that login (default Void User). Then enter and confirm the password for this default user. Finally you may choose to modify the group memberships for the user or go with the defaults.


Determine whether you'd like to use the installer to automatically install Wikipedia-logo.png GRUB2 to the disk, or choose none if you'd like to install/configure a bootloader manually after completing the installation process.


Void does not provide an automatic/preset partition scheme, so you will need to create this manually using cfdisk. Please be sure to read the disclaimer regarding partition table formatting information if you are unfamiliar with the differences between BIOS/UEFI and MBR/GPT. Upon completion of your partitioning, choose 'Write' in cfdisk, type the word 'yes' to confirm, and select 'Quit' to return to the Void installer. See Disks for further information.


Create the filesystems used to populate the partitions you just created. Choose your filesystem type, specify the mountpoint and create the filesystem, if necessary, for each partition you mean to modify. Once finished, select Back to return to the main installer menu. See Filesystems.

Review Settings

Before installing, it is generally a good idea to review the installation settings. Arrow right from the main menu to select settings and use <enter> to review.


This step of the installer creates the filesystems specified in the previous step, then downloads all of the base packages (if configured to install via Network) and copies them to the target partition/partitions configured in the previous steps. After that, the installer generates an Wikipedia-logo.png initramfs and installs GRUB2 to the bootable partition.

After the installation is successfully completed, you can reboot into your new Void Linux install!


Once you boot into your new Void installation, continue to Post-installation for further configuration tips.