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
| Provider | What Bilbis uses it for |
|---|---|
| GitLab | Clone GitLab projects, push branches, open merge requests, and receive GitLab webhooks. |
| GitHub | Clone GitHub repositories, push branches, open pull requests, and receive GitHub webhooks. |
Steps
- Open Settings.
- Open Integrations.
- Select Add credential.
- Choose GitLab or GitHub.
- Add a clear label.
- Paste the token.
- 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
| Problem | What to check |
|---|---|
| Git provider option is disabled while adding a repo | Add the matching GitLab or GitHub credential first. |
| Repository discovery does not show a repo | Confirm the token can access the repo in GitLab or GitHub. |
| Pipeline cannot push a branch | Check that the token has write access, not read-only access. |
| Pipeline cannot open an MR/PR | Check provider permissions and branch protection rules. |