Child pages
  • Git

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

The plugin is bundled in the latest since TeamCity 5.0 EAP.
If you installed the plugin manually, please remove it from .BuildServer/plugins when using TeamCity 5.0 and later.

This page contains information for those who need to use the plugin with TeamCity

General Info




Apache 2.0


free, open-source

Plugin Description

Adds Git support.

Plugin Development Status

Early access program is open. Snapshot builds are available.
Everyone is encouraged to try the plugin, however issues can be uncovered.

TeamCity Versions Compatibility


The current plugin version is designed to work with TeamCity 4.5. It will not work with previous TeamCity versions.


Directly from public TeamCity server: last build


The VCS is visible as "Git (JetBrains)" in VCS chooser to eliminate confusion with third-party plugin.

The implementation is powered by JGit.
Only server-side checkout is supported. Personal builds ( remote run and pre-tested commit) are not yet supported in any of the IDE.

The following protocols are supported:

Known Issues

  • Tagging is not supported over HTTP protocol (JGit limitation)
  • For SSH to work you should have correctly configured $HOME\.ssh-* Specify references to the keys in appropriate host sections (keys with passphrases do not work yet)
    • You will need to specify "StrictHostKeyChecking" to "no" if you do not want for ssh to fail when connecting new hosts.
    • The file could be used to specify host aliases
  • Plugin creates temporary bare repositories in ~/.BuildServer/system/caches/git this repositories are not cleaned up automatically. This directory are shared for different VCS roots with the same URL. See teamcity.remote configuration property to see URL for which directory is used.


The implementation is powered by JGit.

Plugin is described in the TeamCity documentation (Git).

Plugin is open-sourced and can be used as an example of TeamCity VCS support implementation. See the links below.

Plugin Development Status

Stable, production quality.

TeamCity 4.5.x Versions

If you want to use Git with TeamCity 4.5.x, you can download the plugin directly from the public TeamCity server: last build for TeamCity 4.5.

Then install it:

  1. Put into <TeamCity Data Directory>/plugins folder.
  2. Restart the server.

It is possible to to configure the following system properties for the Git plugin:






Timeout in seconds for transport that is used when the branch were never fetched



Timeout in seconds for transport that is used when the branch were previously fetched

Agent Checkout Support

Only available since TeamCity 5.1.1.
The git plugin contains experimental support for agent side checkout. The agent checkout does not support SSH yet. This support is implemented using C git, so you need to have git installed on all the agents that you plan to use agent-side git checkout on. The git executable is searched on the agent in the following paths:

  • Windows (git.exe)
    • C:\Program Files\Git\bin
    • C:\Program Files (x86)\Git\bin
    • C:\cygwin\bin
  • Unix (git)
    • /usr/local/bin
    • /usr/bin
    • /opt/local/bin
    • /opt/bin

If the git is located in non-standard location or if you have serveral git distributions installed and want select a specific one, specify full path to git executable the using property system.git.executable.path in on the agent. For example:

Code Block



If you believe you've faced a bug: Issue Tracker
If you want to ask a question or discuss: Forum
Any of the above, but you do not want it to be publicly accessible: Feedback email



For details on configuring a Git VCS Root and known issues description, please refer to TeamCity documentation.

Clone URL:
Builds at JetBrains public TeamCity instance.

Related Materials

Tracker Issue







Added submodules support. Submodules are treated as a logical part of working tree from point of view of collect changes and build patch operations.

Original tracker issue