azurephabricator

Configure an external repository

Phabricator supports Git, Mercurial and Subversions protocols. You can check the documentation for advanced configuration.

To configure an existing GitHub repository with Phabricator, follow these steps:

  • Log in to Phabricator as an administrator.

  • Select the “Diffusion” tab in the menu.

  • On the resulting page, click the “Create repository” link in the top right corner.

    External repository configuration

  • Create a Git, Mercurial or Subversion repository. This example will use a Github repository.

    External repository configuration

  • Enter a human-readable name for the repository and an internal “callsign”.

    External repository configuration

  • On the repository details page, select the “URIs” option in the left navigation bar and click the “Add New URI” button.

    External repository configuration

  • Enter the external repository’s clone URL in the “URI” field and set the “I/O Type” to “Observe”. You can obtain the clone URL from the repository’s Github page. Click the “Create Repository URL” button to create the new URL.

    External repository configuration

  • If the remote Github repository is not public and requires credentials for access, click the “Set Credential” button on the URL detail page.

    External repository configuration

  • In the resulting dialog, click “Add Credential” and enter the username and password for the repository. Click the “Create Credential” button once done to save the new credentials.

    External repository configuration

  • By default, the repository will be visible to all users and editable by administrators. If you wish to change these access policies, from the repository details page, select the “Policies” option in the left navigation bar and click the “Edit Policies” button.

    External repository configuration

  • Modify the policies as needed and click “Save Changes” to save the changes.

    External repository configuration

  • On the repository details page, choose the “Activate Repository” option to begin importing the repository.

    External repository configuration

If all goes well, your repository will be imported and when you select the “Status” option in the left navigation bar, you will see a success page like the one below.

External repository configuration

Phabricator will now continuously and automatically synchronize with the remote Github repository and display commits and changes as they happen.

You can also access the repository later from the “Diffusion” tab, which will show you a list of active repositories and the latest commit in each. Clicking the repository name will display detailed information on the repository.

External repository configuration