Manual Page Search Parameters

XBPS-RINDEX(1) General Commands Manual XBPS-RINDEX(1)

xbps-rindexXBPS utility to manage local binary package repositories


The xbps-rindex utility creates, updates and removes obsolete binary packages stored in local repositories.

Enables extra debugging shown to stderr.
none | gzip | bzip2 | xz | lz4 | zstd
Set the repodata compression format. If unset, defaults to zstd.
Check not only for file existence but for the correct file hash while cleaning. This flag is only useful with the mode.
Forcefully register binary package into the local repository, overwriting existing entry. Or forcefully create a package signature, even if there's an existing one already. This flag is only useful with the or modes.
Show the help message.
Show the version information.
This is required to sign a repository, a description of the person signing the repository, i.e name and email.
Path to the private RSA key to sign the repository. If unset, defaults to ~/.ssh/id_rsa.

/path/to/repository/binpkg.xbps ...
Registers the binary package into the local repository. The specified binary package is only added to the index if its version is greater than the one currently stored, use -f to forcefully register existing packages. Multiple binary packages can be specified as arguments. Absolute path to the local repository is expected.
Removes obsolete entries found in the local repository. Absolute path to the local repository is expected.
Removes obsolete packages from repository. Packages that are not currently registered in repository's index will be removed (out of date, invalid archives, etc). Absolute path to the local repository is expected.
Initializes a signed repository with your specified RSA key. Note this only adds some metadata to the repository archive to be able to sign packages. If the --privkey argument not set, it defaults to ~/.ssh/id_rsa.
/path/to/repository/binpkg.xbps ...
Signs a binary package archive with your specified RSA key. If --privkey argument not set, it defaults to ~/.ssh/id_rsa. If there's an existing signature, it won't be overwritten; use the -f option to force the creation.

Overrides uname(2) machine result with this value. Useful to install packages with a fake architecture.
Sets the target architecture to this value. This variable differs from XBPS_ARCH in that it allows you to install packages partially, because configuration phase is skipped (the target binaries might not be compatible with the native architecture).
If this is set, it will use this passphrase for the RSA private key when signing a repository. Otherwise it will ask you to enter the passphrase on the terminal.

xbps-checkvers(1), xbps-create(1), xbps-dgraph(1), xbps-digest(1), xbps-fbulk(1), xbps-fetch(1), xbps-install(1), xbps-pkgdb(1), xbps-query(1), xbps-reconfigure(1), xbps-remove(1), xbps-uchroot(1), xbps-uunshare(1), xbps.d(5)

Juan Romero Pardines <>
Enno Boland <>

Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life.

Report bugs at

February 21, 2020