How do I stop builds on agents to prepare for routine Jenkins maintenance?


  • Besides the “Safe Restart” plugin, is there a way to stop agents from building in cases where you would like to upgrade operations center or controllers?
  • Do I have to stop all the agent nodes one at a time and then bring things up in a controlled manner?
  • Is there a way to stop Jenkins from executing any new jobs?


CloudBees Jenkins Enterprise


  1. The safeRestart function is actually in Jenkins core (just navigate to /safeRestart); this will prevent any new builds from starting and will allow existing builds to complete. The “Safe Restart” plugin just adds a button for this.

  2. There is also the /quietDown functionality - which will have Jenkins stop taking on new builds but will not trigger the restart.

  3. Finally, CloudBees Jenkins Enterprise also has a Quiet Start function, which will allow you to restart Jenkins, essentially in the Quiet Mode (ie: running but not accepting new builds). Docs on this feature are here:

Have more questions?


  • 1
    Brian M

    What about acting upon individual slave nodes without affecting other slave nodes? For example, to have a slave node finish building current jobs but not start new jobs, is it better to "disconnect" / "take node offline" or is it better to set a node to have zero executors, or something else?

Please sign in to leave a comment.