Skip to content
This repository has been archived by the owner on Mar 29, 2020. It is now read-only.

Latest commit

 

History

History
36 lines (25 loc) · 3.05 KB

SetupHowTo.wiki

File metadata and controls

36 lines (25 loc) · 3.05 KB

  1. summary System prerequisites, Installation and upgrade howto
  2. labels Featured

Table of Contents

System prerequisites

 * Windows XP SP3 or newer is required
 * For Windows 7, SP1 is required; For Windows Vista, SP2 is required
 * Admin privileges for the installation
 * [http://www.microsoft.com/en-us/download/details.aspx?id=8483 Windows Installer 4.5] (required since !TortoiseGit 1.7.15.2)
 * [https://msysgit.github.io/ Git for Windows] is required by !TortoiseGit (sometimes also mentioned as msysGit)
   * 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
   * Git for Windows/msysGit 1.9.5+ is recommended for !TortoiseGit 1.7.9+ (Git for Windows/msysGit 1.7.10 adds utf-8 support and is compatible to `*`nix git)
   * minimum compatible version is 1.6.1 (for !TortoiseGit < 1.7.9 you should use Git for Windows/msysGit 1.7.6)
   * (Cygwin and Msys2 Git also work, see [https://tortoisegit.org/docs/tortoisegit/tgit-dug-settings.html#tgit-dug-settings-main manual] 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

Just [Download] the setup package for your system and install it. If you are running a 64 bit system, you do not need to download and install the 32 bit version: The 32 bit shell extension is included in the 64 bit installer since !TortoiseGit 1.7.3.0.

Upgrade

Before upgrading you should read the ReleaseNotes.

Just [Download] the setup package for your system and install it. The old version will be replaced automatically. If possible use the automatic updater of !TortoiseGit (in this case the binaries are cryptographically verified).

If you are upgrading from 1.7.3.0 or older and you have installed the 32-bit version on a 64-bit system you have to uninstall the 32-bit version first.

Common problems (installer aborts with an error message)

"This installation package is not supported by this processor type. Contact your product vendor."

This means you are trying to install the 64-bit version of !TortoiseGit on a normal 32-bit operating system. You need to download and use the correct msi file for your OS. For normal 32-bit OS, make sure the msi filename does not have "64-bit" in it.

"There is a problem with this Windows Installer package. A DLL required for this install to complete could not be run. Contact your support personnel or package vendor."

There seems to be a problem with the "Microsoft Visual C++ 2012 Redistributable". Try to repair it (or download and install it). See issue #2061.

"Please wait while the installer finishes determining your disk space requirements."

Cleanup/empty the temp-directory (e.g. C:\Users\<your></your>\!AppData\Local\Temp, C:\User and Settings\<your></your>\Local Settings\Temp, c:\Windows\Temp\).