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 10:56, 5 November 2015 by Sth (talk | contribs)
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. For a more-detailed installation walkthrough, please see the Beginners' Guide.

Getting Started

Download the Void live image ISO from http://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 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


Set your keyboard layout based on available options -- choose whatever seems closest to your keyboard layout.


This step allows you to set up the network settings used for the installer. Select a network interface to configure, then choose to use DHCP or configure the network settings manually. The installer will confirm your network connectivity.


Choose whether you want to install from a local source (the packages that are included on 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.


Set a hostname for your computer.


Configure your default locale settings.


Set your timezone based on standard timezone options. Configure your default locale settings.


Set your timezone based on standard timezone options.


Enter and confirm the password used for the root account on your new Void installation.


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 followed by 'Quit' to return to the Void installer. See 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.


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.