You are viewing the documentation of TeamCity 10.x and 2017.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.


Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: minor updates

Clean-up in TeamCity is a feature allowing automatic deletion of data belonging to old builds.

Since TeamCity 9.0, projectProject-related clean-up settings are configured in the Project Settings (not in the prior to TeamCity 9.0, the Server Administration | Clean-up Settings section like in previous versionswas used).

The general clean-up configuration is available in the server Administration | Clean-up Settings.


The server settings are configured on the Administration | Server Administration | Clean-up Settings.

Since TeamCity 9.0, the The build history clean-up is run as a background process, which means that now there is no server maintenance down-time.
(warning) If you use the HSQL database, there is a short period of server unavailability when the HSQL database is being compacted.


  • Artifact patterns. The artifacts matching the specified pattern will be included in/excluded from the clean-up. Use newline-delimited rules following Ant-like pattern. Example: to  
    - to clean-up artifacts with 'file' as a part of the name, use the following syntax: +:**/file*.*. To  
    - to exclude *.jar artifacts with 'file' as a part of the name from clean-up, use -:**/file*.jar.