// 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
Share

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

  1. FIX 1Free disk and temp space

    1. 01Delete old workspaces and builds (Discard old builds, Workspace Cleanup)
    2. 02Clear old files from /tmp
    3. 03Run df -h to confirm free space
    Did this fix it?
  2. FIX 2Enlarge /tmp or add swap

    1. 01Resize the /tmp partition (e.g. to 2 GB+)
    2. 02On small VMs add a swap file if the swap monitor complains
    Did this fix it?
  3. FIX 3Adjust the thresholds

    1. 01Go to Manage Jenkins > Nodes > Configure Monitors (or <jenkins URL>/computer/configure)
    2. 02Lower the Free Temp Space / Free Disk Space thresholds or untick a monitor you don't need
    3. 03Save
    Did this fix it?
  4. FIX 4Bring the node back

    1. 01Open the node page and click Bring this node back online
    2. 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 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 not loading, error messages & connection guides →

Other Jenkins errors

All 14 Jenkins errors and fixes →