// troubleshooting guide · jenkins
Jenkins Node Offline: 'Disk Space Is Too Low'
- Status
- Workaround available
- platforms:
- Jenkins controller and agents
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · jenkins/disk-space-too-low4 FIXES
// quick answer
Jenkins' disk, temp and swap monitors took the node offline. Free space (often /tmp), raise the partition size or adjust the thresholds, then bring the node back online.
Most likely fix: Free disk and temp space
How to fix it
// try these in order, the most common fix is first
FIX 1Free disk and temp space
- 01Delete old workspaces and builds (Discard old builds, Workspace Cleanup)
- 02Clear old files from /tmp
- 03Run df -h to confirm free space
Did this fix it?FIX 2Enlarge /tmp or add swap
- 01Resize the /tmp partition (e.g. to 2 GB+)
- 02On small VMs add a swap file if the swap monitor complains
Did this fix it?FIX 3Adjust the thresholds
- 01Go to Manage Jenkins > Nodes > Configure Monitors (or <jenkins URL>/computer/configure)
- 02Lower the Free Temp Space / Free Disk Space thresholds or untick a monitor you don't need
- 03Save
Did this fix it?FIX 4Bring the node back
- 01Open the node page and click Bring this node back online
- 02If it stays offline after freeing space, restart Jenkins
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
The built-in node or an agent shows offline with 'Disk space is too low' or 'Free Temp Space below threshold', and builds wait for an executor forever.
Why it happens
- C-01Workspace or build data filled the disk
- C-02/tmp is a small separate partition (e.g. under 1 GB)
- C-03No swap space on small cloud VMs
- C-04Thresholds set higher than the machine can meet
// this guide also covers
- jenkins disk space is too low
- jenkins built-in node offline
- jenkins free temp space below threshold
- jenkins node offline disk space
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 usThe same problem in other apps
Other Jenkins errors
- Jenkins Build Stuck 'Waiting for Next Available Executor'
- Jenkins Build Stuck and Won't Abort
- Jenkins Plugins Failed to Load After Update
- Jenkins Not Starting: 'Job for jenkins.service failed'
- Jenkins java.lang.OutOfMemoryError: Java Heap Space
- Why Is Jenkins So Slow?
- Jenkins 'Scripts Not Permitted to Use Method' Error
- Jenkins GitHub Webhook Not Triggering Build