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
Mar 29, 2014
Source Code
Issue Tracking
Open Issues
n/a (id: ikedam)
Usage Installations 2013-Apr 6305
2013-May 6434
2013-Jun 6597
2013-Jul 6940
2013-Aug 6912
2013-Sep 7211
2013-Oct 7544
2013-Nov 7617
2013-Dec 7626
2014-Jan 8047
2014-Feb 8361
2014-Mar 8682

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.13 (Mar 29, 2014)

  • Added "No Activity" timeout strategy, which triggers timeout when no log output for specified seconds. (issue #13349)
  • Actions performed when timeout occurs can be extended using extension points. (issue #21929)
  • 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 (issue #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 (issue #18618).

Version 1.11 (Oct 28, 2012)

  • Change to build timeout job configuration not saved (issue #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 (19 issues)
Type Key Summary
Bug JENKINS-21543 "Likely stuck" timed out the build after 0 minutes
Improvement JENKINS-21043 Notify but Don't Cancel a long running build
New Feature JENKINS-20526 Allow timouts to be set via parameter
Bug JENKINS-20164 Plugins Build-timeout and FSTrigger cannot be used in the same job
New Feature JENKINS-19883 Thread dump when a build time out
New Feature JENKINS-19773 Add the build timeout parameter
Improvement JENKINS-16875 Builds do not timeout when job hangs in post build actions
Bug JENKINS-13666 FATAL: Timer already cancelled.
New Feature JENKINS-12744 Execute a command before timeout
Improvement JENKINS-11064 Update ambiguous ABORTED message to "TIMED OUT" and fix raised InterruptedException
Improvement JENKINS-10822 e-mail should be sent when the build is aborted
Bug JENKINS-10439 IOException while archiving AND wrong build status
Improvement JENKINS-9716 allow timeouts to occur during pre-build
Improvement JENKINS-9457 Build Timeout value field should accept any sort of parameter
New Feature JENKINS-8947 Allow a build to be restarted X amount of times if it times out
Bug JENKINS-7832 Hudson build time is calculated from the time job enters the queue while it should be when job actually starts to run
New Feature JENKINS-7513 Add the timeout globally by default for all projects not only by project
Improvement JENKINS-2936 Using build-timeout plugin to stop build but not force the build abort or failed
Improvement 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