Find Git and set your commit identity
GitTree runs the Git installed on your computer and never bundles one. It needs Git 2.39 or newer, and a name and email for your commits (user.name and user.email), which it asks for the first time a commit needs them.
Works in GitTree Free: every local Git feature, once you are signed in.
On this page
Before you start
- GitTree is installed. Git is checked when it starts.
Where to find it
- If Git is missing or too old, GitTree shows GitTree needs Git or This Git is too old when it starts.
- Preferences › General › Git executable for another Git; Preferences › Profiles for identities.
| Action | macOS | Windows and Linux |
|---|---|---|
| Preferences | ⌘, | Ctrl+, |
Steps
Let GitTree find Git
GitTree looks for Git when it starts. If it is missing, the window lists where it looked and how to install Git on your system; install it, then choose Check again.
Point to another Git, if you have several
Choose Locate Git… in that window, or set Git executable in Preferences › General.
Set your identity
The first time a commit needs a name and email, Set up your Git identity opens. Type the Name and Email your commits should carry.
Choose where it is saved
Under Where to save it, choose this repository only (
.git/config), every repository (~/.gitconfig), or a new GitTree profile that changes no Git config file. Press Save.
Expected result
GitTree says Your Git identity is saved. Commit again, and the commit carries that name and email.
Several identities
A profile is a name and email for commits, plus an optional signing key and SSH command, that you can switch between: work and personal, for example. Create one in Preferences › Profiles with New profile, and use Switch to this profile to change.
If something goes wrong
“This Git is too old”
GitTree needs Git 2.39 or newer. Update Git, or point GitTree to a newer Git with Locate Git….
“This Git could not be used”
The Git found did not answer when asked for its version. Reinstall it, or choose another with Locate Git….
Questions
Which email should I use?
The one your hosting service knows, so commits are linked to your profile there. GitHub, for example, can give you a private no-reply address.