bpkg-pkg-configure - Man Page

configure package


bpkg pkg-configure [options] [cfg-var...] pkg


The pkg-configure command configures either the previously unpacked (bpkg-pkg-unpack(1), bpkg-pkg-checkout(1)) source code package or a package that is present in the system.

A source code package inherits the common build2 configuration values that were specified when creating the configuration (bpkg-cfg-create(1)). Additional package-specific configuration variables can be passed to pkg-configure (cfg-var).

A system package is specified using the sys:pkg[/ver] syntax. If the package version (ver) is not specified, then it is considered to be unknown but satisfying any dependency constraint. Such a version is displayed as *.

Pkg-Configure Options

--directory|-d dir

Assume configuration is in dir rather than in the current working directory.

Common Options

The common options are summarized below with a more detailed description available in bpkg-common-options(1).


Print essential underlying commands being executed.


Print all underlying commands being executed.


Run quietly, only printing error messages.

--verbose level

Set the diagnostics verbosity to level between 0 and 6.

--jobs|-j num

Number of jobs to perform in parallel.


Don't print informational messages about the outcome of performing a command.


Suppress progress indicators for long-lasting operations, such as network transfers, building, etc.

--build path

The build program to be used to build packages.

--build-option opt

Additional option to be passed to the build program.

--fetch path

The fetch program to be used to download resources.

--fetch-option opt

Additional option to be passed to the fetch program.

--fetch-timeout sec

The fetch and fetch-like (for example, git) program timeout.

--pkg-proxy url

HTTP proxy server to use when fetching package manifests and archives from remote pkg repositories.

--git path

The git program to be used to fetch git repositories.

--git-option opt

Additional common option to be passed to the git program.

--sha256 path

The sha256 program to be used to calculate SHA256 sums.

--sha256-option opt

Additional option to be passed to the sha256 program.

--tar path

The tar program to be used to extract package archives.

--tar-option opt

Additional option to be passed to the tar program.

--openssl path

The openssl program to be used for crypto operations.

--openssl-option opt

Additional option to be passed to the openssl program.

--auth type

Types of repositories to authenticate.

--trust fingerprint

Trust repository certificate with a SHA256 fingerprint.


Assume the answer to all authentication prompts is yes.


Assume the answer to all authentication prompts is no.

--pager path

The pager program to be used to show long text.

--pager-option opt

Additional option to be passed to the pager program.

--options-file file

Read additional options from file.

--default-options dir

The directory to load additional default options files from.


Don't load default options files.

Default Options Files

See bpkg-default-options-files(1) for an overview of the default options files. For the pkg-configure command the search start directory is the configuration directory. The following options files are searched for in each directory and, if found, loaded in the order listed:


The following pkg-configure command options cannot be specified in the default options files:



Send bug reports to the users@build2.org mailing list.

Referenced By

bpkg(1), bpkg-pkg-build(1), bpkg-pkg-clean(1), bpkg-pkg-disfigure(1), bpkg-pkg-install(1), bpkg-pkg-test(1), bpkg-pkg-uninstall(1), bpkg-pkg-update(1).

July 2020 bpkg 0.13.0