NAME

       gbp-create-remote-repo - Create a remote Git repository

SYNOPSIS

       gbp create-remote-repo [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=
                              COLOR_SCHEME] [--remote-url-pattern= url-pattern] [--remote-name= name]
                              [--template-dir= directory] [--remote-config= config] [--[no-]pristine-tar]
                              [--debian-branch= branch_name] [--upstream-branch= branch_name] [--[no-]track]
                              [--[no-]bare] [create | list]

DESCRIPTION

       gbp create-remote-repo  creates a repository at a remote location via ssh and pushes the local repository
       into it. It then sets up remote branch tracking so you can use gbp pull to update  your  repository  from
       there.

       Before  performing  any action on the remote location, it will print the remote URL and ask for confirma‐
       tion.

       Note: By default, the remote repositories are created in the collab-maint repository on git.debian.org.

       When invoked with list it lists the available remote config templates.

OPTIONS

       --version
              Print version of the program, i.e. version of the git-buildpackage suite

       -v, --verbose
              Verbose execution

       -h, --help
              Print help and exit

       --color=[auto|on|off]
              Whether to use colored output.

       --color-scheme=COLOR_SCHEME
              Colors to use in output (when color is enabled). The  format  for  COLOR_SCHEME  is  '<debug>:<in‐
              fo>:<warning>:<error>'.  Numerical values and color names are accepted, empty fields imply the de‐
              fault  color.  For example, --git-color-scheme='cyan:34::' would show debug messages in cyan, info
              messages in blue and other messages in default (i.e. warning and error messages in red).

       --remote-url-pattern=pattern
              Where to create the remote repository. The part %(pkg)s will be replaced by the package name.

       --remote-name=name
              What name git will use when referring to that repository, e.g.  'origin'.

       --template-dir=directory
              Template directory to pass to git init on the remote side. This can be used to customize  the  re‐
              mote repository, e.g. to set up hooks.

       --remote-config=config
              Name  of  a  config  file section in gbp.conf that specifies the above parameters. See gbp.conf(5)
              manpage for details.

       --debian-branch=branch_name
              The branch in the Git repository the Debian package is being developed on, default is master.

       --upstream-branch=branch_name
              The branch in the Git repository the upstream sources are put onto. Default is upstream.

       --pristine-tar
              Whether to push the pristine tar branch.

       --[no-]track
              Whether to set up branch tracking for the debian, upstream and pristine-tar branches.

       --[no-]bare
              Whether the remote repository should be a bare repository (this is the default).

CONFIGURATION FILES

       Several gbp.conf files are parsed  to  set  defaults  for  the  above  command-line  arguments.  See  the
       gbp.conf(5) manpage for details.

SEE ALSO

       gbp-buildpackage(1), gbp-pull(1), gbp.conf(5)

AUTHOR

       Guido Günther <agx@sigxcpu.org>

                                                  10 April 2025                        gbp-create-remote-repo(1)