Create and view repos

Similar to the depot spec, each Git repo stored in the P4 Server is represented by a repo spec. You can create, update, and delete repo specs by running the p4 repo command. For details, see p4 repo in the P4 CLI Reference.

All P4 customers (both licensed and unlicensed) can create up to 3 repositories. To obtain more licenses, contact your Perforce Sales representative.

As of the 2021.1 release (patch 1 or greater), all licensed customers of P4 can create unlimited repositories for no additional charge.

Each repo has an owner (a user or a group). By default, the user who creates the repo is the owner, and this user's user name appears in the Owner field of the Repo specification. The owner automatically acquires repo-wide admin privileges and is responsible for managing access controls for that repo. See p4 grant-permission in the P4 CLI Reference.

If you do not specify a branch for the DefaultBranch field, the default branch might be refs/heads/master. If your project uses another name, see Specify a default branch.

The MirroredFrom field is updated automatically during mirroring configuration. For details, see the chapter One-way mirroring from Git servers.

It is possible to enable automatic creation of a repo when you use the git push command to push a new repo into the P4 Server. You configure this behavior with the p4 grant-permission command. For details, see Manage access to graph depots and repos and p4 grant-permission in P4 CLI Reference.

You can view a list of the Git repos on your server by runnning the p4 repos command. Similarly, Git users can run the following command to view a list of repos:

$ git clone git@ConnectorHost:@list

  1. To create a new Git repo in an existing graph depot, run the following command:

    $ p4 repo //graphDepotName/repoName
  2. Edit the resulting spec as needed.

In this section: