PKG-UPDATE(8)           FreeBSD System Manager's Manual          PKG-UPDATE(8)

NAME

     pkg update - update the local catalogues of the enabled package
     repositories

SYNOPSIS

     pkg update [-fq] [-r reponame ...]

     pkg update [--{force,quiet}] [--repository reponame ...]

DESCRIPTION

     pkg update is used for updating the local copy of the repository
     catalogues from the remote package repository databases.  Updates to
     catalogues are normally downloaded only when the master copy on the
     remote package repository is newer than the local copy.

     The repository catalogues to be updated are defined in the pkg.conf(5)
     file or by the entries in /usr/local/etc/pkg/repos.  See pkg.conf(5) for
     details.

     It is best practice to ensure your package repository catalogues are up
     to date before doing any package installation (via pkg-install(8)) or
     upgrades (via pkg-upgrade(8)).  However, explicitly running pkg update is
     not normally necessary.  By default invoking either of pkg install or pkg
     upgrade will cause repository catalogues to be updated automatically,
     unless disabled by setting REPO_AUTOUPDATE to false in pkg.conf(5).

Signed repositories

     If the repository catalogue is signed and PUBKEY is defined for the
     repository, the signature will be verified after download.  See
     pkg.conf(5) for more information.

OPTIONS

     The following options are supported by pkg update:

     -q, --quiet
            Force quiet output.

     -f, --force
            Force a full download of the repository catalogue without regard
            to the respective ages of the local and remote copies of the
            catalogue.

     -r reponame, --repository reponame
            Download the catalogue for the named repository only.  This option
            can be specified multiple times to update several repositories.
            This will update only the named repositories, irrespective of the
            configured "enabled" status from repo.conf.

ENVIRONMENT

     The following environment variables affect the execution of pkg update.
     See pkg.conf(5) for further description.

     PKG_DBDIR

     REPO_AUTOUPDATE

FILES

     See pkg.conf(5).

SEE ALSO

     pkg_checksum(3), pkg_create(3), pkg_printf(3), pkg_repo_create(3),
     pkg_repos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5),
     pkg-script(5), pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8),
     pkg-alias(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8),
     pkg-check(8), pkg-checksum(8), pkg-clean(8), pkg-config(8),
     pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-help(8), pkg-info(8),
     pkg-install(8), pkg-key(8), pkg-lock(8), pkg-plugins(8), pkg-query(8),
     pkg-register(8), pkg-repo(8), pkg-repositories(8), pkg-rquery(8),
     pkg-rwhich(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8),
     pkg-ssh(8), pkg-stats(8), pkg-triggers(8), pkg-unregister(8),
     pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg-which(8)

FreeBSD 15.1-STABLE-HBSD         July 7, 2024                    PKG-UPDATE(8)