From Void Linux Wiki
Revision as of 12:46, 25 August 2017 by GreattoBeGrateful (talk | contribs) (Added re cfdisk: 'type the word 'yes' to confirm, and select 'Quit'')
Jump to: navigation, 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. For a more-detailed installation walkthrough, please see the Beginners' Guide.

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 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 limage 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.


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.


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


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 chose 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 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#Partitioning 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 Disks#Filesystems

Review Settings

Before installing, its 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 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.