= gerrit create-branch

== NAME
gerrit create-branch - Create a new branch.

== SYNOPSIS
[verse]
--
_ssh_ -p <port> <host> _gerrit create-branch_
  <PROJECT>
  <NAME>
  <REVISION>
--

== DESCRIPTION
Creates a new branch for a project.

== ACCESS
Caller should have link:access-control.html#category_create[Create Reference]
permission on the project.

Administrators do not automatically have permission to create branches. It must
be granted via the Create Reference permission.

== SCRIPTING
This command is intended to be used in scripts.

== OPTIONS
<PROJECT>::
    Required; name of the project.

<NAME>::
    Required; name of the branch to be created.

<REVISION>::
    Required; base revision of the new branch.

== EXAMPLES
Create a new branch called 'newbranch' from the 'master' branch of
the project 'myproject'.

----
$ ssh -p 29418 review.example.com gerrit create-branch myproject newbranch master
----

GERRIT
------
Part of link:index.html[Gerrit Code Review]

SEARCHBOX
---------