Throttle Concurrent Builds Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID throttle-concurrents Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.8.4 (archives)
Oct 09, 2014
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Andrew Bayer (id: abayer)
Oleg Nenashev (id: oleg_nenashev)
Usage Installations 2014-Nov 4508
2014-Dec 4630
2015-Jan 4809
2015-Feb 5059
2015-Mar 5403
2015-Apr 5487
2015-May 5536
2015-Jun 5830
2015-Jul 6119
2015-Aug 6131
2015-Sep 6349
2015-Oct 6514

This plugin allows for throttling the number of concurrent builds of a project running per node or globally.

To set an unlimited value of concurrent builds for the project or node, use "0".

Per Single-Job

On the job-page, you select Throttle Concurrent Builds and then specify Maximum Total and/or Maximum Per Node:

These settings only apply to this specific Job and do not apply to any categories you may additionally select.

It should be noted that Jenkins, by default, never executes the same Job in parallel, so you do not need to actually throttle anything if you go with the default. However, there is the option Execute concurrent builds if necessary, which allows for running the same Job multiple time in parallel, and of course if you use the categories below, you will also be able to restrict multiple Jobs.)

Per Project-Category

When using Multi-Project Throttle Categories the maximum values are chosen in the global configuration where you define the category:

When a Job is throttled, its Per-Job maximum values are checked first, and if these succeed its categories are checked.


The source for this plugin is in GitHub, at


1.8.4 (Oct 09, 2014)
1.8.3 (Jul 2, 2014)
1.8.2 (released March 7, 2014)
  • JENKINS-21044 - Fixes blocker issue with thread concurrency locks.
1.8.1 (released Dec 08, 2013) - UNSTABLE
  • JENKINS-19623 - Minimize security checks to improve performance of build queue dispatcher
    The version has a "blocker" issue caused by threads concurrency. See JENKINS-21044 for more info.
1.8 (released Sept 20, 2013)
  • JENKINS-19645 - Categories optionally configured with pairs of throttled node labels.
  • Fix for working on Jenkins 1.480.3.
  • Optimizing performance by changing from getComputers to getNodes.
  • JENKINS-12240 - Fixing handling of MatrixProjects and MatrixConfigurations.
1.7 (2011)
  • You now choose either to throttle the builds for just this project, or to throttle as part of a category.
1.6 (released Apr 25, 2011)
  • Now checks all criteria until one rejects the build or all have been checked, rather than allowing the build to run as soon as one criteria passes.
1.5 (released Feb 23, 2011)
  • Matrix configurations are now throttled under the rules defined for their parent matrix project.
1.4 (released Feb 22, 2011)
  • Fixed problem with categories not checking for projects in pending state.
1.3 (released Oct 15, 2010)
  • Multiple categories per job now allowed.
1.2 (released Sept 27, 2010)
  • Categories weren't saving due to not having a setter. (JENKINS-7221)
1.1.1 (released Sept 24, 2010)
  • Added ability to turn off throttling of a job, because it was not possible. Which was silly.
  • Fixed a problem when run in Hudson 1.377 or greater, due to changes in queue logic. (JENKINS-7559)
  • Added support for "categories" - throttling multiple jobs as if they were one.
  • Initial version.


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

Add Comment