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.
-
Create a Git, Mercurial or Subversion repository. This example will use a Git repository.
-
Enter a human-readable name for the repository and an internal “callsign”. Then click the “Create repository” button.
-
On the repository details page, select the “URIs” option in the left navigation bar and click the “Add New URI” button.
-
Enter the external repository’s clone URL in the “URI” field and set the “I/O Type” to “Observe: Copy from a remote”. You can obtain the clone URL from the repository’s Github page. Click the “Create Repository URL” button to create the new URL.
-
If the remote Github repository is not public and requires credentials for access, click the “Set Credential” button on the URL detail page.
-
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.
-
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.
-
Modify the policies as needed and click “Save Changes” to save the changes.
-
On the repository details page, choose the “Activate Repository” option to begin importing the repository.
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.
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.
