If you are installing Void for the first time or the Void RSA key has changed, xbps-install(1) might report:
<repository> repository has been RSA signed by <rsa_fingerprint>
If there are any errors while updating or installing a new package, make sure
that you are using the latest version of the remote repository index. Running
xbps-install(1) with the
will guarantee that.
An "Operation not permitted" error, such as:
ERROR: [reposync] failed to fetch file https://alpha.de.repo.voidlinux.org/current/nonfree/x86_64-repodata': Operation not permitted
can be caused by your system's date and/or time being incorrect. Ensure your date and time are correct.
A "Not Found" error, such as:
ERROR: [reposync] failed to fetch file `https://alpha.de.repo.voidlinux.org/current/musl/x86_64-repodata': Not Found
An "unresolvable shlib" error, such as:
libllvm8-8.0.1_2: broken, unresolvable shlib `libffi.so.6'
is probably due to outdated or orphan packages. To check for outdated packages,
simply try to update your system. Orphan packages, on
the other hand, have been removed from the Void repos, but are still installed
on your system; they can be removed by running
xbps-remove(1) with the
If you get an error message saying:
Transaction aborted due to unresolved shlibs
the repositories are in the staging state, which can happen due to large builds. The solution is to wait for the builds to finish. You can view the builds' progress in the Buildbot's Waterfall Display.
In March 2020, the compression format used for the repository data (repodata)
was changed from gzip to zstd. If XBPS wasn't updated to version
(released June 2019) or newer, it is not possible to update the system with it.
Unfortunately, there isn't an error message for this case, but it can be
detected by running
xbps-install with the
-Sd flags. The debug message for
this error is shown below.
[DEBUG] [repo] `//var/db/xbps/https___alpha_de_repo_voidlinux_org_current/x86_64-repodata' failed to open repodata archive Invalid or incomplete multibyte or wide character
In this situation, it is necessary to follow the steps in xbps-static.
If your system is for some reason broken and can't perform updates or package installations, using a statically linked version of xbps to update and install packages can help you avoid reinstalling the whole system.