This section includes general information about the process of installing Void. For specific guides, see the "Advanced Installation" section.
Base system requirements
Void can be installed on very minimalist hardware, though we recommend the following minimums for most installations:
|i686-glibc||Pentium 4 (SSE2)||96MB||700MB|
Note that xfce image installations require more resources.
Void is not available for the i386, i486, or i586 architectures.
Before installing musl Void, please read the "musl" section of this Handbook, so that you are aware of software incompatibilities.
It is highly recommended to have a network connection available during install to download updates, but this is not required. ISO images contain installation data on-disk and can be installed without network connectivity.
Downloading installation media
The most recent live images and rootfs tarballs can be downloaded from https://repo-default.voidlinux.org/live/current/. They can also be downloaded from other mirrors. Previous releases can be found under https://repo-default.voidlinux.org/live/, organized by date.
Each image release's directory contains two files used to verify the image(s)
you download. First, there is a
sha256sum.txt file containing image checksums
to verify the integrity of the downloaded images. Second is the
file, used to verify the authenticity of the checksums.
It is necessary to verify both the image's integrity and authenticity. It is, therefore, recommended that you download both files.
Verifying image integrity
You can verify the integrity of a downloaded file using
sha256sum(1) with the
file downloaded above. The following command will check the integrity of only
the image(s) you have downloaded:
$ sha256sum -c --ignore-missing sha256sum.txt void-live-x86_64-musl-20170220.iso: OK
This verifies that the image is not corrupt.
Verifying digital signature
Prior to using any image you're strongly encouraged to validate the signatures on the image to ensure they haven't been tampered with.
Current images are signed using a signify key that is specific to the release.
If you're on Void already, you can obtain the keys from the
package, which will be downloaded using your existing XBPS trust relationship
with your mirror and package signatures. You will also need a copy of
minisign(1); on Void, these are provided
minisign packages, respectively.
signify when using a Linux distribution or operating system other
than Void Linux:
- Install the
signifypackage in Arch Linux and Arch-based distros.
- Install the
signify-openbsdpackage in Debian and Debian-based distros.
- Install the package listed here for your distribution.
signify-osxwith homebrew in macOS.
minisign executable is usually provided by a package of the same name, and
can also be installed on Windows, even without WSL or MinGW.
If you are not currently using Void Linux, it will also be necessary to obtain the appropriate signing key from our Git repository here.
Once you've obtained the key, you can verify your image with the
sha256sum.txt files. First, you need to verify the authenticity of the
The following examples demonstrate the verification of the
for the 20210930 images. Firstly, with
$ signify -V -p /etc/signify/void-release-20210930.pub -x sha256sum.sig -m sha256sum.txt Signature Verified
And secondly, with
$ minisign -V -p /etc/signify/void-release-20210930.pub -x sha256sum.sig -m sha256sum.txt Signature and comment signature verified Trusted comment: timestamp:1634597366 file:sha256sum.txt
Finally, you need to verify that the checksum for your image matches the one in
sha256sum.txt file. This can be done with the
sha256(1) utility, again from the
package, as demonstrated below for the 20210930
$ sha256 -C sha256sum.txt void-live-x86_64-20210930.iso (SHA256) void-live-x86_64-20210930.iso: OK
Alternatively, if the
sha256 utility isn't available to you, you can compute
the SHA256 hash of the file, e.g. using
sha256sum(1), and compare it to the
value contained in
$ sha256sum void-live-x86_64-20210930.iso 45b75651eb369484e1e63ba803a34e9fe8a13b24695d0bffaf4dfaac44783294 void-live-x86_64-20210930.iso $ grep void-live-x86_64-20210930.iso sha256sum.txt SHA256 (void-live-x86_64-20210930.iso) = 45b75651eb369484e1e63ba803a34e9fe8a13b24695d0bffaf4dfaac44783294
If the verification process does not produce the expected "OK" status, do not use it! Please alert the Void Linux team of where you got the image and how you verified it, and we will follow up on it.