TeamCity
 
You are viewing the documentation for an earlier version of TeamCity.

VCS Checkout Mode

Last modified: 20 April 2023

The Version Control Settings page for a build configuration allows configuring how project source code is retrieved from VCS: you can attach a VCS Root here and configure checkout options.

The VCS Checkout mode is a setting that affects how project sources reach an agent. This mode affects only sources checkout. The current revision and changes data retrieving logic is executed by the TeamCity server and thus TeamCity server needs to access the VCS server in any mode.

Depending on the version control used, agents can require command line clients installed and available in PATH on the agents (e.g. Perforce, Git, Mercurial).

The checkout mode is configured on the build configuration's Version Control Settings page, in the Checkout Options section (an advanced setting).

TeamCity has the following VCS checkout modes: