Connect xltrail with a Git repository

Add a repository

1. Login to xltrail as admin

2. Go to Settings > Integrations > Git. Then click on Add Repository:

   

3. If you are using a system like GitHub, GitLab, Bitbucket etc.: Paste the Git url of your repository as shown in the screenshot.

   Make sure to paste the http(s) (and not the ssh) version of your git url. Also, if your Git provider (e.g. Bitbucket) starts the url with your username, make sure to remove it including the @.

   If you are using a git remote directly on the file system, you need to:

   • Mount the directory as subdirectory of the following directory on the xltrail server: /xltrail/integrations/git
   • Specify Repository URL as follows: file:///xltrail/integrations/git/<my-repo>, leaving user and password empty.
   Please restart xltrail after mounting the directory by clicking on "Stop Now" and "Start" again in the management console on port 8800.

4. Set the username and password to access your repository. Note, you only need read-access, which allows you to use a token that most providers offer or even force you to use if you have two-factor-authentication enabled. Follow the instructions below for the most popular Git providers.

Tokens

Github Cloud & Enterprise

Under Personal settings > Developer settings > Personal access tokens, you can Generate new token. Tick the repo checkbox so you get access to all the subitems in that box.

GitLab Cloud & CE/EE

Create a personal access token under User Settings > Access Tokens. Tick the api checkbox under Scopes.

Bitbucket Cloud

• Personal Accounts: You can create an app password under Bitbucket Settings > Access Management > App password. Tick the checkboxes Repository (read) and Pull Requests (read).

• Team Accounts: You can create an API key to use with your team name under Bitbucket Settings> Access Management > API key.

Bitbucket Server

Bitbucket Server (the on-premise version of Bitbucket) introduced personal access tokens with version 5.5.

On lower versions, you can either use an existing user or create a dedicated xltrail user:

• Log in as Bitbucket administrator
• Under "Administration" click on Users, then Create user
• Pick something like xltrail as the username

To finalize, you need to give this user read access either on Project or Repository level.