Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 6.5.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.

Table of Contents

Build Configuration describes a class of builds of a particular type, or a procedure used to create builds. Examples of build configurations are integration builds, release builds, nightly builds, and others.

You can explore details of a build configuration on its home page and modify its settings on the editing page. In this section:

Build Configuration State

A build configuration is characterized with its state which can be paused or active. By default, when created all configurations are active.

If a build configuration is paused, its automatic build triggers are disabled until the configuration is activated. Still, you can start a build of a paused configuration manually or automatically as a part of a build chain. Besides, information on paused build configurations is not displayed on the My Changes page.

To pause or activate a build configuration do one of the following:

  • On the Build Configuration settings page click the Pause/Activate button.
  • Navigate to the Build Configuration Home Page, click Actions on the toolbar and select Pause build configuration/Activate build configuration from the drop-down.

Build Configuration Status

In general, build configuration status reflects the status of its last finished build.


Personal builds do not affect the build configuration state.

You can view the build configuration status on the Projects page or Project Home Page, when the details are collapsed.



The last build executed successfully.

The last build with this build configuration executed with errors or one of the currently running builds is failing. The build configuration status will change to "failed" when there's at least one currently running and failing build, even if the last finished build was successful.

Indicates that someone has started investigating the problem, or already fixed it. (see Investigating Build Problems).

no icon

There were no finished builds for this configuration, status is unknown.

The build configuration is paused; no builds are triggered for it. Click on the link next to the status to view by whom it was paused, and activate configuration, if needed.

Build Configuration ID

Each build configuration has an internal unique identifier which you may need when constructing TeamCity URLs or editing TeamCity configuration manually.

Automatically assigned IDs use bt<NUMBER> format.

To determine the internal ID of a build configuration:

  • Navigate to the build configuration home page and in page URL, find the buildTypeID=btXXX parameter (see picture below). The btXXX value is the value you search for.

See also: