Configuration Files

The configuration files are parsed in this order:

/etc/git-buildpackage/gbp.conf

system wide configuration

~/.gbp.conf

per user configuration

.gbp.conf

per repository/branch configuration (deprecated)

debian/gbp.conf

per repository/branch configuration

.git/gbp.conf

per (local) repository configuration

All have the same format. They consist of several sections, all of them are optional:

[DEFAULT]

Options in this section apply to gbp buildpackage, gbp import-orig, gbp import-dsc and gbp dch.

[buildpackage]

Options in this section apply to gbp buildpackage only and override options from the [DEFAULT] section.

[import-orig]

Options in this section apply to gbp import-orig only and override options from the [DEFAULT] section.

[import-dsc]

Options in this section apply to gbp import-dsc only and override options from the [DEFAULT] section.

[dch]

Options in this section apply to gbp dch only and override options from the [DEFAULT] section.

...

Same for the other gbp commands

The actual options in these sections are the command line options without the '--' prefix. So --upstream-branch=dfsgfree would read:

upstream-branch=dfsgfree

in the config file. In the special case of gbp buildpackage, the stripped prefix is not '--' but '--git-'. Here's a more complete example:

[DEFAULT]
# the default build command
builder=debuild -i\.git -I.git
# the default branch for upstream sources
upstream-branch=upstream
# the default branch for the debian patch
debian-branch=master

[buildpackage]
upstream-branch=dfsgclean
# Sign tags with GPG:
sign-tags = True
# Keyid to sign tags with
#keyid = 0xdeadbeef

[import-orig]
upstream-branch=notdfsgclean

[import-dsc]
upstream-branch=notdfsgclean

[dch]
git-log=--no-merges

For more details, see the gbp.conf(5) manual page.