Create and view repos

Similar to the depot spec, each Git repo stored in the Helix 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 Helix Core Command-Line (P4) Reference.

Note

All Helix Core 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 Helix Core 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 Helix Core Command-Line (P4) Reference.

Note

  • If you do not specify a branch for the DefaultBranch: field, the default branch is 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 Helix 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 Helix Core Command-Line (P4) 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.

Also in this section: