Connecting Git

:grey-exclamation: Available in the Free plan

If you prefer to skip Git for now, you can move on to Exploring Your Environment Config

Git is a version control system, designed to track source code changes and allow developers collaboration. It introduces the following benefits:

  • Always-relevant documentation - using Git as your team's main source of documentation, easily accessing the context of any feature or change, making future changes less risky.
  • Peer review - popular Git providers come with features for peer review, giving you the opportunity to read through changes, identify bugs, and build shared standards as a team.
  • Debugging and reverting - Git helps you to quickly identify a change that introduced a certain bug and to easily address the bug, either by releasing an updated version of your configuration or by reverting to an older bug-free version.


Salto integrates with the following Git providers:

  • GitHub, GitLab and Bitbucket are integrated directly.
  • Git on-premise and other Git cloud providers such as Azure DevOps are supported as well. Please reach out via chat (left pane => support) or [email protected] and we will help set you up.

Follow the below instructions to connect your Git provider to Salto.

To set up Git, first make sure that you have access to a Git repository (this is where your source code changes are tracked and stored), with write permissions (aka not ‘push protected’) to an empty branch. You may need to contact your IT department in order to make this happen.

Then open the left pane and click on your username at the bottom -> Git Settings. The Git Settings modal has 4 tabs for GitHub, GitLab, Bitbucket and 'Other' for on-premise and other Git providers. Select your desired tab and continue per the below instructions.

Connecting Salto with your Git provider allows Salto to interact with your Git provider and your organization's repositories on your behalf. This allows Salto to pull and push configuration file changes to your git repositories. Your Git provider username will be the author of those changes.

GitHub / GitLab / Bitbucket

Click ‘Authorize’. This will take you to your Git provider where you will be asked to Authorize SaltoLabs. Approve the request. Then you will be redirected back to Salto. The relevant Git Settings tab should now show your Git provider’s username under the ‘Authorized Account’ title.

If you are using Github, please continue to the section below. Otherwise, you should be able to see your repositories in the Salto app.


At this point you most likely cannot yet see your repos in Salto. Salto's GitHub app must be installed on your GitHub organization for Salto to have access (this is in addition to your authorizing Salto's app to act on your behalf earlier).
To do so, from the Salto app -> Git Settings -> GitHub tab:

  • Click ‘Resolve on Github’. You should land on a GitHub installation page
  • Click on the name of your organization. You should see now specific details for installing Salto's app on your GitHub organization:
    • All repositories is the recommended choice of visibility, so that you can easily use new repositories in Salto without having to deal with settings ever again
    • If you see a button labeled ‘Install’, clicking it will complete the installation and redirect you back to Salto
    • If the button is labeled ‘Request’, your GitHub organization admin should receive a request notification from GitHub to approve your installation request, since your user has insufficient privileges. We recommend talking directly with your GitHub admin, as GitHub notifications are easy to miss

Once your installation was approved and completed successfully you should be able to see your repositories with the Salto app.


If you are on the 'Other' tab, you will see a URL field where you should add the HTTPS URL of your Git on-premise or Git cloud provider. Then add your authentication details, commit email address and add your provider.

  • When copying the URL from your Git service to Salto's Git settings, be sure to only copy the main URL, excluding the project name, which is the URL ending segment. The project name should be pasted when configuring Git with a Salto workspace.
  • If you are using a Git on-premise, follow the Firewall configuration section below to make sure Salto can access your Git repos.

:fire: FireWall configuration for Git on-premise providers

In order to allow Salto to access your on-premise Git, please follow the instructions in this page


You've connected your Git Provider to Salto

Now Salto can interact with your Git provider and your organization's repositories on your behalf. This is how you allow Salto to pull and push configuration files to your git repositories on your behalf, i.e. so your Git provider user will be the author of those changes.