Skip to content
1014

E-Series add fails with EOF when root capacity is too low

Summary

A failure to add an E-Series system with an EOF error can be caused by low root partition capacity on NAbox. In this state, deployment or refresh of required container images may fail, and the add workflow can surface only a generic EOF error. Resolve by increasing root capacity (preferred durable fix) or by performing manual cleanup to free space, then retry.

Quick checklist (operator)

  1. Check root free space:
df -h /

  1. If root is low (or near full), apply the durable fix: Increase root partition size on existing deployments.

  2. If immediate growth is not possible, free space temporarily:

docker image prune -f

  1. Retry adding the E-Series system.

  2. If it still fails, collect diagnostics and escalate (see escalation section).

Why this happens

The E-Series add flow depends on backend components that may require updated container images. On older or saturated deployments, root filesystem pressure can prevent successful image pull/unpack operations.

When this happens, the user-facing symptom may be a generic EOF instead of a clear capacity error.

Identify if this KB applies

Run:

df -h /

If / is low on free space, this KB likely applies.

Optional quick checks for image/disk pressure:

docker system df
sudo du -hs /var/lib/docker/*

Remediation path A (preferred): increase root capacity

Use the durable procedure in: Increase root partition size on existing deployments.

After growth/reboot, validate:

df -h /

Then retry adding the E-Series system.

Remediation path B (temporary): free space manually

If root expansion cannot be done immediately, free space and retry:

docker image prune -f

If needed, investigate large consumers:

sudo du -hs /var/log/*
sudo du -hs /var/lib/docker/*

If container logs are large, follow: Container logs filling up disk space in /var/lib/docker.

Then retry adding the E-Series system.

Temporary fix

Manual cleanup can restore service quickly but does not address long-term growth requirements. Plan root partition expansion as a permanent fix.