The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


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


version 2.051


In your dist.ini:

    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


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.


Bugs may be submitted through the RT bug tracker (or

There is also a mailing list available for users of this distribution, at

There is also an irc channel available for users of this distribution, at #distzilla on


Jerome Quelin


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.