TeamCity 2019.2 Help

TeamCity Configuration and Maintenance

To edit the server configuration:

On the Administration page, select Global Settings.

The TeamCity Configuration section of the page displays the following information:




The database used by the running TeamCity server.

Data Directory

The <TeamCity Data Directory> path with the ability to browse the directory.

Artifact directories

The list of the root directories used by the TeamCity server to store Build Artifact, build logs and other build data. The default location is /system/artifacts. Note that artifacts can also be stored on external storage.

The list can be changed by specifying a new-line delimited list of paths. Absolute and relative (to TeamCity Data Directory) paths are supported.All the specified directories use the same structure.

When looking for build artifacts, the specified locations are searched for the directory corresponding to the build. The search is done in the order the root directories are specified. The first found build artifacts directory is used as the source of artifacts of this build.

Artifacts for the newly starting builds are placed under the first directory in the list.

Caches directory

The directory containing TeamCity internal caches (of the VCS repository contents, search index, other), which be manually deleted to clear caches.

Server URL

The configurable URL of the running TeamCity server.

The Build Settings section allows configuring the following settings:



Maximum build artifact file size

Maximum size in bytes. KB, MB, GB or TB suffixes are allowed. -1 indicates no limit

Default build execution timeout

Maximum time for a build. Can be overridden when defining build failure conditions.

The Version Control Settings controls the following:



Default VCS changes check interval

Set to 60 seconds by default. Specifies how often TeamCity polls the VCS repository for VCS changes. Can be overridden when configuring VCS roots.

Additionally, you can enforce the interval of VCS changes check as a minimum polling interval for all VCS roots on the server. This way, Project Administrators will only be able to set intervals that are larger than the default one. This helps restrict the frequency of polling requests thus offloading the server.

Default VCS trigger quiet period

Set to 60 seconds by default. Specifies a period (in seconds) that TeamCity maintains between the moment the last VCS change is detected and a build is added into the queue. Can be overridden when configuring VCS triggers.