Baz Docs
Sign Up ↗Contact sales
  • Introduction
  • Basics
    • Organization Setup
    • Configure with GitHub
    • Security, privacy and compliance
  • Code
    • Overview
    • Integrations
      • Datadog
      • GitHub Actions
      • Slack
      • Jira
  • Notifications
  • changes
    • Overview
      • Description
      • Topics
        • Commands
      • Diff
        • Git Diff (optional)
    • Reviewer
    • Chat
    • Comments
    • Suggestions
    • Merge eligibility
Powered by GitBook
On this page
  • Install Baz GitHub App
  • Permissions to Comment and Merge
  • Reconfigure
  1. Basics

Configure with GitHub

Integrate Baz with GitHub repos to mirror your team's codebase and review changes.

PreviousOrganization SetupNextSecurity, privacy and compliance

Last updated 4 months ago

After successfully authenticating, you will be redirected into your private Baz workspace. Select Connect to GitHub to select which organization and repositories you would like to integrate with Baz.

Note: If your GitHub admin already integrated your organization, you will be able to select it from the organization navigation menu.

Install Baz GitHub App

You will be redirected to the GitHub app installation page. Select the organization or user account where you want to install the Baz GitHub app. Choose the repositories that Baz should access and click the Install button to complete the installation.

That's it. You've succusfuly installed Baz. You will now be redirected back to Baz to see your Code and open Changes.

Permissions to Comment and Merge

Next, we'll need to allow users to perform code review activities such as commenting, suggesting code changes and most importantly, merging.

To start, add a comment to any open Change. You will be redirected to GitHub to authorize the required permissions.

Based on your admin access level you will see 3 possible options:

Grant: This means you have admin access required to authorize Baz's configuration and you can go ahead and grant access to complete the integration.

Request: This means you do not have suffiant access to complete the integration. A request to Grant access to Baz will be sent via GitHub to your organization admin.

Authorized (✔): This means your organization is already configured in Baz and you should be able to access it by toggling from your personal Baz workspace to this GitHub organization.

Important: Before clicking "Authorize baz-scm" ensure you selected Grant on any organization you want to integrate with Baz.

Reconfigure

At any point, you can go back and reconfigure GitHub by going to your Settings.

Click the Configure button to connect Baz to GitHub. This will redirect you to GitHub’s authorization page. If you aren’t logged in, log in to your GitHub account. Once logged in, you will see a permission request page where Baz requests access to your account. Review the permissions and click the Authorize Baz button to grant access.

Connect to GitHub
Authorizing Baz on GitHub
Go to Settings
Click Configure