Integrating your Salto environment with a Git branch enables version control and collaboration for your application configuration. Before setting up the connection, consider the following authentication and permission requirements:
Shared Git User for Automatic Pushes
All configuration changes deployed through Salto, or done directly in the environment and fetched by Salto, will be pushed to this branch.
You will need to provide a shared Git account. Salto will use this account to push all fetched changes to the git branch, so it must have the necessary permissions to push commits.
In this mode, the environment branch is exclusively managed by Salto. Application configuration updates to this branch are handled solely through Salto fetches and deployments.
For changes to files like CSVs, READMEs, CI files, or similar, you can submit a pull request through the Version Control section on the Environment Settings page in the Salto UI. Learn more
To keep everything running smoothly, please avoid making direct changes to the branch outside of Salto.
Alternatively, you can enable manual push mode. In this mode, automatic pushes will not occur, and protection via PRs will not be available.
Personal Git Credentials for Deployments
Each team member deploying to this environment must authenticate using their personal Git credentials.
If deployment pull requests are enabled, the user must have permission 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.
More information per supported Git provider:
Other cloud or on-prem Git services and installations are supported as a native Git integration by providing your Git URL, credentials and commit email.
Setting Up a Git Connection
Navigate to the Environment Settings
Go to the ‘Version Control’ Section
Click on ‘Connect Git’
Define Your Git Usage:
Choose your preferred push settings:
Automatically push every change (recommended)
Manually select and push changes
Enable deployment protection via pull requests. Learn more.
Enable SFDX integration to manage your configuration in Git using the SFDX project format (salesforce only)
You will be promoted to authenticate with shared Git credentials.
(If manual push mode is enabled, you will be prompted to authenticate with your personal Git credentials).
Select a repository and click ‘Next’
Select or Create a branch and click ‘Select/Create Branch and Link’
