Build-timeout Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID build-timeout Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.15.1 (archives)
Nov 21, 2015
token-macro (version:1.5.1)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
n/a (id: ikedam)
Usage Installations 2014-Nov 11128
2014-Dec 11012
2015-Jan 11565
2015-Feb 11806
2015-Mar 12394
2015-Apr 12466
2015-May 12666
2015-Jun 13123
2015-Jul 13610
2015-Aug 13652
2015-Sep 14165
2015-Oct 14383

This plugin allows you to automatically abort a build if it's taking too long. Once the timeout is reached, Jenkins behaves as if an invisible hand has clicked the "abort build" button.


After installing the plugin, go to the configure page for your job and select "Abort the build if it's stuck".

Because Java only allows threads to be interrupted at a set of fixed locations, depending on how a build hangs, the abort operation might not take effect. For example,
  • if Jenkins is waiting for child processes to complete, it can abort right away.
  • if Jenkins is stuck in an infinite loop, it can never be aborted.
  • if Jenkins is doing a network or file I/O within the Java VM (such as lengthy file copy or SVN update), it cannot be aborted.

So if you think the build time out isn't taking effect, our default assumption is that the build is hanging at the place that cannot be interrupted. If you suspect otherwise, please obtain the thread dump and report it.


Version 1.15.1 (Nov 21, 2015)

Version 1.15 (Jul 26, 2015)

Version 1.14.1 (Jan 03, 2015)

  • FIXED: timeout actions don't defaults to 'abort build' when no option is selected (JENKINS-23740)
  • Added license notice (MIT) (JENKINS-21270)
  • Improved the performance of NoActivityTimeOutStrategy (JENKINS-26170)

Version 1.14 (Jun 01, 2014)

  • Now targets Jenkins 1.466.
  • This version breaks binary compatibility.
    • This can affect you onlt in following cases (In other words, this does not affect most users)
      • When you have private plugins accessing inner information of Build-timeout plugin.
      • When you have groovy scripts accessing inner information of Build-timeout plugin.
  • Resolved a performance problem introduced in 1.13 by capturing log outputs. (JENKINS-23012)
  • Use dropdown for strategy instead of hetero-radio, as it can conflicts with other plugins. (JENKINS-20164)
  • FIXED: Enable BuildStep Action in System Configuration page was not saved to the disk. (JENKINS-23118)
  • Supported launcher in Perform Buildstep. (JENKINS-23117)
  • Allow use of ${...} style expressions in defining the build timeouts. (JENKINS-9457, JENKINS-19773, JENKINS-20526)

Version 1.13 (Mar 29, 2014)

  • Added "No Activity" timeout strategy, which triggers timeout when no log output for specified seconds. (JENKINS-13349)
  • Actions performed when timeout occurs can be extended using extension points. (issue #21919)
  • expose the build timeout milliseconds with an environment variable
  • "Perform BuildStep" timeout action is added. It allows you to trigger any build step when timeout.
    • It does not ensure any build steps work correctly.
    • As it is provided as an advanced feature, you need to enable it in System Configuration page to enable in project configuration pages.

Version 1.12.2 (Oct 14, 2013)

  • Fixed missing strategies selection when a new job is created (JENKINS-19592)
  • Fixed missing label selecting time-out strategy

Version 1.12 (Sep 7, 2013)

  • Fix elastic timout (pull #12).
  • Define an extension point for time-out strategy (pull #14).
  • Build Timeout Plugin configuration interface shows all sub options (JENKINS-18618).

Version 1.11 (Oct 28, 2012)

  • Change to build timeout job configuration not saved (JENKINS-14158).
  • Clarified timeoutMinutesElasticDefault's name (pull #11).

Version 1.10 (Jun 16, 2012)

  • Build timeout plugin 1.9 always sets timeout period to 3 minutes ([]).
  • updated to LTS 1.447
  • updated Japanese localization.

Version 1.9 (March 12, 2012)

  • amend build description on timeout
  • elastic timeout option to define timeout as a percent of previous build duration
  • "likely stuck" option

Version 1.8 (Aug 27, 2011)

  • Marking a build as failed works now as expected.
  • Japanese translation

Version 1.7 (Mar 20, 2011)

  • Clarify in help text that marking build as failed instead of aborted does still abort the build.
  • Write more detail in log when build is aborted.

Version 1.6 (Dec 28, 2009)

  • Remove debug output
  • Update uses of deprecated APIs

Version 1.5

  • Option to mark builds as failed or aborted.

Version 1.4

  • The plugin now works with the native maven2 job type as well as the matrix job type.


To report a bug or request an enhancement to this plugin please create a ticket in JIRA.

JIRA Issues (13 issues)
Type Priority Key Summary
Bug Trivial JENKINS-30564 timeoutMinutesElasticDefault should be used until numberOfBuilds is not reached out
New Feature Minor JENKINS-26778 Build-timeout+Plugin global timeout setting
Improvement Minor JENKINS-26563 BlockableBuildTrigger invokes build timeout
Improvement Major JENKINS-23137 Show a message in the console log when a build timeout occurs
New Feature Major JENKINS-19883 Thread dump when a build time out
Improvement Major JENKINS-16875 Builds do not timeout when job hangs in post build actions
New Feature Major JENKINS-12744 Execute a command before timeout
Improvement Trivial JENKINS-11064 Update ambiguous ABORTED message to "TIMED OUT" and fix raised InterruptedException
Improvement Major JENKINS-9716 allow timeouts to occur during pre-build
New Feature Major JENKINS-8947 Allow a build to be restarted X amount of times if it times out
New Feature Major JENKINS-8900 allow time limit to be specified for build step
Improvement Major JENKINS-2936 Using build-timeout plugin to stop build but not force the build abort or failed
Improvement Critical JENKINS-789 build-timeout — ver.1.3: should kill the all process tree.


plugin-buildwrapper plugin-buildwrapper Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment