// troubleshooting guide · jenkins

Jenkins Build Stuck and Won't Abort

Status
Workaround available
platforms:
Jenkins controller (all OS)
updated:
November 16, 2026
reports:
2
Method
how we research
Share

RUNBOOK · jenkins/build-stuck-wont-abort3 FIXES

// quick answer

Use the build's stop, then term, then kill URLs in that order. If the executor still hangs, read the thread dump to see what it's blocked on.

Most likely fix: Stop, then terminate, then kill

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Stop, then terminate, then kill

    1. 01Send a POST to <build URL>/stop (same as the abort button)
    2. 02If it keeps running, POST to <build URL>/term to forcibly terminate it
    3. 03Only as a last resort, POST to <build URL>/kill to hard-kill the pipeline
    Did this fix it?
  2. FIX 2Find the blocked thread

    1. 01Open <jenkins URL>/threadDump
    2. 02Find the executor thread named after the agent and executor number
    3. 03Read the stack trace to see what the step is waiting on and fix that cause
    Did this fix it?
  3. FIX 3Prevent it next time

    1. 01Add options { timeout(time: 1, unit: 'HOURS') } to declarative pipelines
    2. 02Wrap risky steps (network calls, input) in their own timeout block
    Did this fix it?

SANDBOX · jenkins RUNS IN YOUR BROWSER

Try it: push, review, run CI and merge in a code host and cloud workspace

A hands-on Jenkins-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

A running build hangs forever; clicking the red X does nothing or the build keeps showing 'Aborting'.

Why it happens

  • C-01A step is blocked on a process, network call or input that never returns
  • C-02The executor thread doesn't respond to the interrupt
  • C-03No timeout is set on the pipeline or step

// this guide also covers

  • jenkins build stuck
  • jenkins abort stuck build
  • jenkins build hangs
  • jenkins kill running build

Still not working?

If Jenkins keeps failing, you're not alone. See every Jenkins problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Jenkins Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All export, render & quality loss guides →

Other Jenkins errors

All 14 Jenkins errors and fixes →