Skip to main content
To complete the configuration, navigate to Settings > Advanced > Git Version Control, then click Configure. Git version control configuration pane

Provide the following:

  • The URL to your remote Git repository. If you are using SSH, do not enter the HTTPS address here; you must use the SSH address (for example, git@github.com:username/private-repo.git). All major Git platforms are supported (such as GitHub, GitLab, Bitbucket, and Azure DevOps).

  • Your auth scheme. Once you select an auth scheme, the fields required for configuration appear.

    • HTTPS: The Username and Password or Token to connect to the repository.
    • SSH: The SSH Private Key file and Passphrase to connect to the repository. See Authenticating with SSH for more information.
    • OAuth: Click Get Access Token to retrieve the access token that allows you to connect.
When you click Save, runs an initialization task. This initialization creates a Git repository inside AppDirectory, creates a branch named settings-before-git-init-<initialization_date> that contains the configuration that exists at initialization, and stages those configuration files for commit. This ensures that no configurations are lost in the event that the remote repository already has content that would conflict with those settings. The footer changes to a status bar showing Git metrics and actions such as the current number of local files changed, the current branch, and (for remote repositories) the number of remote commits. For remote repositories, click Commit and Push on the toolbar to push the initial commit. Git version control footer toolbar

​
Authenticating with SSH

Follow these steps to authenticate using SSH:
  • Run ls -al ~/.ssh to check for an existing SSH key.
  • If you have an existing key, you can use it. Alternatively, run this command to generate a new SSH public/private key pair: ssh-keygen -t ed25519 -C "your_email@example.com".
  • Optionally, add a passphrase to the key for added security.
  • Use the SSH Private Key field to upload your private key.
  • Add the public SSH key to your Git platform.
For more information on how to authenticate with SSH, review your Git platform’s documentation.

​
Removing a Git Configuration

To remove your Git version control configuration, click the trashcan icon on the settings panel, then choose a Git Repository Option:
  • Leave the underlying repository intact: disconnects from the repository, but the .git folder remains on disk. You can still interact with the repository directly using Git tools on the server.
  • Remove the underlying repository: Deletes the .git folder, fully disabling version control on this installation. Any staged changes are permanently lost.
After removing the configuration, you can set up version control again at any time by clicking Configure.