Connecting Git

:arrow-right-hook: If you prefer to skip Git for now, you can skip to Creating your first workspace.


Supported Git integrations

  • GitHub, GitLab and Bitbucket are integrated directly.
  • Git on-premise and other Git cloud providers are supported as well. Please reach out via chat or [email protected] and we will help set you up.

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

:wrench: Your Git Settings page

  • You can access Git settings by clicking your name at the top-right corner of the app, then clicking Git Settings.
  • Also, if you haven't connected any Git source to your workspace yet, you should have a button labeled Connect to Git.

:unlock: Authorizing Salto to access your Git provider

  • The Salto Git Settings page has 4 tabs for GitHub, GitLab, Bitbucket and 'Other' for on-premise and other Git cloud providers (contact support to enable the 'Other' tab).
  • Select your desired tab.
  • Clicking the 'Authorize' button in the first 3 tabs will take you to your Git provider where you will be asked to Authorize SaltoLabs - approve the request.
    • You'll be redirected back to Salto. The relevant Git Settings tab should now show your Git provider username under Authorized Account
    • If you are using GitHub, please follow the Installing Salto on GitHub organizations section below.
  • 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.

:cd: Installing Salto on GitHub organizations

:grey-exclamation: At this point please make sure you have an empty repository created under your team's GitHub organization.

Under GitHub Settings' Repos section you should see all the repositories that meet these conditions:

  • Are empty or contain Salto configuration files
  • Salto's GitHub app has been installed on the GitHub organization (or personal account) that owns them

You most likely cannot see your new repo yet. 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 give Salto access:

  • Click Resolve on Github - you should land on a GitHub installation page
  • Click on the name of your organization - you should see specific details for installing Salto's app on your GitHub organization:
    • All repositories is the recommended choice of visibility, so you can easily use new repositories in Salto without having to deal with settings ever again
    • If the 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 tend to be easy to miss
  • Make sure the installation was approved and completed successfully before continuing

:fire: FireWall configuration for Git on-premise providers

In order to allow Salto to access your on-premise Git, ask your IT admin to configure the firewall to allow our IP addresses on port 443:



You've connected your Git repos to Salto

By 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.

You're ready to create a workspace linked to this repo.


Want to learn more about Salto's Git support?

This guide is focused on helping you complete the onboarding process. For more on why our Git integration works this way, read more here.

Did this page help you?