Setup

Git Providers

Add the GitLab or GitHub access Bilbis needs to work in your repositories.

What this means

A Git provider credential lets Bilbis read repositories, create branches, push code, and open MRs/PRs.

Bilbis supports GitLab and GitHub repositories. A product can contain repositories from either provider, as long as the organization has the matching credential.

When to use it

Add or update a Git provider when:

  • You are setting up Bilbis for the first time.
  • You want to add repositories from GitLab or GitHub.
  • Repository discovery does not show the repo you expect.
  • Pipelines fail because Bilbis cannot clone, push, or open an MR/PR.

Before you start

You need:

  • Owner or admin access in Bilbis.
  • A GitLab or GitHub token with access to the target repositories.
  • Permission in the provider to create branches and MRs/PRs.

Provider choices

ProviderWhat Bilbis uses it for
GitLabClone GitLab projects, push branches, open merge requests, and receive GitLab webhooks.
GitHubClone GitHub repositories, push branches, open pull requests, and receive GitHub webhooks.

Steps

  1. Open Settings.
  2. Open Integrations.
  3. Select Add credential.
  4. Choose GitLab or GitHub.
  5. Add a clear label.
  6. Paste the token.
  7. Save the credential.

After the credential is saved, use the Products page to add repositories from that provider.

What happens next

Bilbis can use the credential for repository setup and pipeline runs. If repository discovery is available for the provider, the Add repo dialog can help you pick from provider-side repositories instead of typing a path manually.

Problems and fixes

ProblemWhat to check
Git provider option is disabled while adding a repoAdd the matching GitLab or GitHub credential first.
Repository discovery does not show a repoConfirm the token can access the repo in GitLab or GitHub.
Pipeline cannot push a branchCheck that the token has write access, not read-only access.
Pipeline cannot open an MR/PRCheck provider permissions and branch protection rules.

On this page