REPO-ADD(8)			 Pacman Manual			   REPO-ADD(8)

NAME
       repo-add - package database maintenance utility

SYNOPSIS
       repo-add [options] <path-to-db> <package> [<package> ...]

       repo-remove [options] <path-to-db> <packagename> [<packagename> ...]

DESCRIPTION
       repo-add and repo-remove are two scripts to help build a package
       database for packages built with makepkg(8) and installed with
       pacman(8).

       repo-add will update a package database by reading a built package
       file. Multiple packages to add can be specified on the command line.

       If a matching “.sig” file is found alongside a package file, the
       signature will automatically be embedded into the database.

       repo-remove will update a package database by removing the package name
       specified on the command line. Multiple packages to remove can be
       specified on the command line.

       A package database is a tar file, optionally compressed. Valid
       extensions are “.db” followed by an archive extension of “.tar”,
       “.tar.gz”, “.tar.bz2”, “.tar.xz”, or “.tar.Z”. The file does not need
       to exist, but all parent directories must exist.

COMMON OPTIONS
       -q, --quiet
	   Force this program to keep quiet and run silently except for
	   warning and error messages.

       -s, --sign
	   Generate a PGP signature file using GnuPG. This will execute gpg
	   --detach-sign on the generated database to generate a detached
	   signature file, using the GPG agent if it is available. The
	   signature file will be the entire filename of the database with a
	   “.sig” extension.

       -k, --key <key>
	   Specify a key to use when signing packages. Can also be specified
	   using the GPGKEY environment variable. If not specified in either
	   location, the default key from the keyring will be used.

       -v, --verify
	   Verify the PGP signature of the database before updating the
	   database. If the signature is invalid, an error is produced and the
	   update does not proceed.

       --nocolor
	   Remove color from repo-add and repo-remove output.

REPO-ADD OPTIONS
       -n, --new
	   Only add packages that are not already in the database. Warnings
	   will be printed upon detection of existing packages, but they will
	   not be re-added.

       -R, --remove
	   Remove old package files from the disk when updating their entry in
	   the database.

       --include-sigs
	   Include package PGP signatures in the repository database (if
	   available)

EXAMPLE
       repo-add foo.db.tar.xz <pkg1> [<pkg2> ...]

       This creates two separate databases; a smaller database “foo.db.tar.xz”
       used by pacman and a large database containing package file lists
       “foo.files.tar.xz” for use by other utilities. While pacman can use the
       large database (if renamed with a db.tar* extension), there is
       currently no additional benefit for the larger download.

SEE ALSO
       makepkg(8), pacman(8)

       See the pacman website at https://archlinux.org/pacman/ for current
       information on pacman and its related tools.

BUGS
       Bugs? You must be kidding; there are no bugs in this software. But if
       we happen to be wrong, please report them to the issue tracker at
       https://gitlab.archlinux.org/pacman/pacman/-/issues with specific
       information such as your command-line, the nature of the bug, and even
       the package database if it helps.

AUTHORS
       Current maintainers:

       •   Allan McRae <allan@archlinux.org>

       •   Andrew Gregory <andrew.gregory.8@gmail.com>

       •   Morgan Adamiec <morganamilo@archlinux.org>

       Past major contributors:

       •   Judd Vinet <jvinet@zeroflux.org>

       •   Aurelien Foret <aurelien@archlinux.org>

       •   Aaron Griffin <aaron@archlinux.org>

       •   Dan McGee <dan@archlinux.org>

       •   Xavier Chantry <shiningxc@gmail.com>

       •   Nagy Gabor <ngaba@bibl.u-szeged.hu>

       •   Dave Reisner <dreisner@archlinux.org>

       •   Eli Schwartz <eschwartz@archlinux.org>

       For additional contributors, use git shortlog -s on the pacman.git
       repository.

Pacman 7.0.0			  2025-06-03			   REPO-ADD(8)