---
name: "Dist::Zilla::Plugin::Git::Push"
section: "3pm"
platform: "linux"
package: "libdist-zilla-plugin-git-perl"
version: "2.051-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Dist::Zilla::Plugin::Git::Push"
---

# Dist::Zilla::Plugin::Git::Push(3pm)

Push current branch

## NAME

Dist::Zilla::Plugin::Git::Push - Push current branch

## VERSION

version 2.051

## SYNOPSIS

In your *dist.ini*:

```
    [Git::Push]
    push_to = origin       ; this is the default
    push_to = origin HEAD:refs/heads/released ; also push to released branch
    remotes_must_exist = 1 ; this is the default
```

## DESCRIPTION

Once the release is done, this plugin will push the current git branch to the remote, with the associated tags.

The plugin accepts the following options:

- •

  push\_to - the name of the a remote to push to. The default is *origin*. This may be specified multiple times to push to multiple repositories.

- •

  remotes\_must\_exist - if true, then Git::Push checks before a release to ensure that all named remotes specified in `"push_to"` are configured in your repo.  The default is true.  Remotes specified as a URL or path are not checked, but will produce a `"Will push to %s (not checked)"` message.

## SUPPORT

Bugs may be submitted through the RT bug tracker \<https://rt.cpan.org/Public/Dist/Display.html?Name=Dist-Zilla-Plugin-Git\> (or bug-Dist-Zilla-Plugin-Git@rt.cpan.org \<mailto:bug-Dist-Zilla-Plugin-Git@rt.cpan.org\>).

There is also a mailing list available for users of this distribution, at \<http://dzil.org/#mailing-list\>.

There is also an irc channel available for users of this distribution, at `"#distzilla"` on `"irc.perl.org"` \<irc://irc.perl.org/#distzilla\>.

## AUTHOR

Jerome Quelin

## COPYRIGHT AND LICENCE

This software is copyright (c) 2009 by Jerome Quelin.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.