TortoiseGit Manual

Installing TortoiseGit

System requirements

TortoiseGit runs on Windows 7 or higher. Windows 98, Windows ME, Windows NT4, Windows 2000, Windows XP and Windows Vista are no longer supported. If you are running such an old system, you can still use older, however unsupported, releases of TortoiseGit. Those can be found on the download server (TortoiseGit 1.7 dropped support for Windows 2000; TortoiseGit 1.9 dropped support for Windows XP, TortoiseGit 2.5 dropped support for Windows Vista).

If you encounter any problems during or after installing TortoiseGit please refer to Appendix A, Frequently Asked Questions (FAQ) first.


TortoiseGit comes with an easy to use installer. Double click on the installer file and follow the instructions. The installer will take care of the rest.

One prerequisite of TortoiseGit is that it requires an already installed (command line) Git client which provides a git.exe. Git for Windows is recommended (Cygwin and MSYS2 Git also work, see the section called “General Settings” for configuration. Please note that Cygwin and MSYS2 Git are not officially supported by TortoiseGit as the developers only use Git for Windows. Bug reports, however, are welcome). Installation of Git for Windows can be done with preselected options, however, no need to install the "Windows Explorer integration". If you know about CRLF and LF line endings and you have editors coping with that, you should select "Checkout as-is, commit as-is" in order to prevent automatic translations.


You need Administrator privileges to install TortoiseGit.

Language Packs

The TortoiseGit user interface has been translated into many different languages, so you may be able to download a language pack to suit your needs. You can find the language packs on our translation status page . And if there is no language pack available yet, why not join the team and submit your own translation ;-)

Each language pack is packaged as a .msi installer. Just run the install program after the installation of the main TortoiseGit package and follow the instructions. After the installation finishes, the translation will be available and can be selected in settings dialog (cf. the section called “General Settings”).

Spell checker

TortoiseGit includes a spell checker which allows you to check your commit log messages. This is especially useful if the project language is not your native language. By default the spell checker uses the same dictionary files as LibreOffice , and Mozilla . TortoiseGit can also use the spell checker shipped with Windows 8+. However, this needs to be enabled manually in advanced settings (key Win8SpellChecker) at the moment.

The installer by default automatically adds the US English dictionary. If you want other languages, the easiest option is simply to install one of TortoiseGit's language packs (see the section called “Language Packs”). This will install the appropriate dictionary files as well as the TortoiseGit local user interface. After the installation finishes, the translation will be available. When using the Windows spell checker, you need to install the dictionary in Windows first.

Or you can install the dictionaries yourself. If you have, LibreOffice or Mozilla installed, you can copy those dictionaries, which are located in the installation folders for those applications. Otherwise, you need to download the required dictionary files from .

Once you have got the dictionary files, you probably need to rename them so that the filenames only have the locale chars in it. Example:

  • en_US.aff

  • en_US.dic

Then just copy them into the %APPDATA%\TortoiseGit\dic folder. If that folder isn't there, you have to create it first. TortoiseGit will also search the Languages sub-folder of the TortoiseGit installation folder (normally this will be C:\Program Files\TortoiseGit\Languages); this is the place where the language packs put their files. However, the %APPDATA%-folder doesn't require administrator privileges and, thus, has higher priority. The next time you start TortoiseGit, the spell checker will be available.

If you install multiple dictionaries, TortoiseGit uses these rules to select which one to use.

  1. Check the tgit.projectlanguage setting. This setting can be set using TortoiseGit Settings Dialogs 3 page (the section called “TortoiseGit Dialog Settings 3”). Refer to git-config(1) man-page for information about setting properties (use the LCID Dec value as assigned by Microsoft).

  2. If no project language is set, or that language is not installed, try the language corresponding to the Windows locale.

  3. If the exact Windows locale doesn't work, try the Base language, e.g. de_CH (Swiss-German) falls back to de_DE (German).

  4. If none of the above works, then the default language is English, which is included by default with the standard installation.

When using the Windows spell checker, this is tried first. If no Windows dictionary, based on these fallback-rules, could be found then the "old" spell checker is used as a fallback.