Adding a repository to a project

A repository from a connected account is added to a project so its events show on that project's tasks. Linked issues, branches, and pull or merge requests then appear on the task and stay current on their own.

First connect your GitHub or GitLab account. See Connecting GitHub and GitLab.

You can add repositories to a project from two places:

1. The Repositories item in the project options menu (the "…" menu in the project header), with Connect Repositories.
2. The Connect a repository link inside the Link Branch or Pull Request dialog on a task.

Add a repository to a project

1. Open the project and select the options menu ("…") in the project header.
2. Select Repositories, then Connect Repositories.
3. In the Repositories list, choose the repositories you want. You can choose several at once, from any connected account.
4. To let issues create and update tasks, select Enable issue sync. It applies to every repository you chose.
5. Select Connect.

The repositories are now added to the project. If some of them can't be added, for example because someone added them to the project in the meantime, the others are still added and ActiveCollab tells you which ones were left out and why.

New branches and pull or merge requests that reference a task appear on that task.

The same dialog works for GitHub and GitLab. On GitLab you see "merge request" and "pipelines" in place of "pull request" and "checks".

Note
Only repositories from a connected account appear in the list. If the one you need is missing, an Owner connects the account first. See Connecting GitHub and GitLab.

Turn on issue sync

With issue sync on, issues from a connected repository create and update tasks in the project.

1. In the Connect Repositories dialog, choose the repositories and select Enable issue sync.
2. Select Connect.

Issue sync applies to every repository you connect together. After that, you can turn it on or off for each repository on its own on the Repositories page.

Note
If the repository is public, anyone on the provider can open an issue, and every issue becomes a task in the project. ActiveCollab warns you when a selected repository is public and issue sync is on. Restrict who can submit issues before you turn sync on.

Sync Now

ActiveCollab learns about changes in a repository as the provider reports them. If a change did not reach ActiveCollab, Sync Now asks GitHub or GitLab for what was missed and updates the linked tasks.

It brings in branches, pull or merge requests, reviews, issues, pipelines, and deployments. Issues are brought in for repositories that have issue sync on.

To sync every repository of one project:

1. Open the project and select the options menu ("…") in the project header.
2. Select Repositories, then Sync Now.

To sync everything under a connection:

1. Go to Apps & Integrations and find the GitHub organization or GitLab group.
2. Open its "…" menu and select Sync Now.

ActiveCollab shows "Sync started" and the changes appear in a few minutes. While the sync runs, the menu item reads Sync In Progress; hover over it to see whether the sync is queued or who started it. If a sync is already running, you can't start another.

Note
Sync Now is for people who can manage the project's repositories: an Owner, or a Project Manager from the owner company who can edit the project. It is not shown for an archived or paused connection.