Prerequisites
Shared Git User for Automatic Pushes
When auto-push is enabled, you will be prompted to authenticate with a shared user, and fetched changes will be pushed on his behalf.
Please ensure that the shared GitHub user has admin permissions for the repository
Personal Git Credentials for Deployments
Each team member deploying to this environment must authenticate with their personal Git credentials.
If deployment pull requests (PRs) are enabled, ensure that the personal Git user has the necessary permissions to create and update PRs for the environment branch, as well as squash and merge them. If PRs are not enabled, the user must have direct push permissions for the environment branch.
Squash and merge settings can be configured in your repository settings under the General section.
Troubleshooting
My repository does not appear in Salto
After you authenticate with your GitHub user, you may not yet see your repos in Salto
-
Salto's GitHub app must be installed on your GitHub organization and have access to the repository you would like to connect.
Granting Repository Access to Salto's GitHub App
Click "Resolve on GitHub" This will open a GitHub page displaying a list of your GitHub organizations.
Select your organization to view Salto’s app repository access details.
Choosing Repository Visibility
Selecting "All repositories" will allow you to easily use new repositories in Salto without needing to update settings manually.
Manually choose the repositories Salto should have access to.
Click on the "Update Access" button and you will be redirected back to Salto. If you see a "Request" button instead, your GitHub organization admin must approve the change. Since GitHub notifications can be easy missed, we recommend reaching out to your admin directly to ensure a quick approval.
Once relevant access was grated to Salto's GitHub app, you should be able to see and select your repositories in the Salto UI.
For on-prem connections such as GitHub Enterprise, read the "Connecting to other Git providers" article.