Skip to main content
Running your own self-managed GitLab server? Go take a look at the GitLab Self-Managed documentation instead. If you are using GitLab.com, this is how you can get started.
Connecting your GitLab group gives Unblocked access to your repositories and merge requests. Unblocked uses this data to answer questions about your code, trace decisions back to merge request discussions, and explain recent changes.
  1. Unblocked keeps its index current as you push commits, so answers always reflect the latest state of your codebase along with its history.
  2. Merge requests and their discussions appear as cited sources in Unblocked’s answers. You’ll also get notifications for active merge request conversations in the Mac app and IDE extensions.

​
Connect your organization and repositories

​
Sign in to Unblocked

Whether you sign in with GitLab credentials, another code repository, or your SSO provider, you first need to authenticate to Unblocked. If you have an existing Unblocked account, you’ll need to select Settings in the sidebar, then Data Sources, then GitLab once you’ve logged in. Otherwise, you’ll be immediately prompted to authorize the Unblocked app.

​
Authorize the Unblocked app

If you aren’t logged into GitLab, you’ll be prompted to do so. Once you’re authenticated to GitLab, you’ll be asked to grant access to Unblocked. This access will allow Unblocked to read the GitLab groups you are a part of as well as check for repositories in those groups, but it won’t begin indexing those repositories yet.

​
Connect your repositories

Once you’ve given access to your GitLab account, Unblocked still needs to know which account’s or group’s repositories you want it to answer questions about. After authorizing access to GitLab, you’ll be redirected back to Unblocked, where you’ll be prompted to select the group or account you want to use with Unblocked. GitLab-Group While you can install Unblocked on any GitLab account or organization, Unblocked works best with your work organization and repositories.
Unblocked preselects the repositories that have been active in the last 6 months. Forked and archived repositories are not preselected.

​
Generating a model for answering questions

Unblocked is able to answer questions for the repositories that it has ingested into its model. After giving Unblocked initial access to your account or group, you’ll choose which repositories it should ingest. You can also select whether all new repositories should be automatically ingested into your Unblocked model. GitLab-Repos Once you select the repositories you want to ask questions about, click Save and Continue, and Unblocked will get to work. While it is certainly possible to use Unblocked without incorporating any further data sources, we strongly encourage you to include as many other systems in which you have documented or even discussed your applications.
If you have restricted network access to your repositories, you may need to allow Unblocked’s IP address ranges.