Context
An ordinary service reports that its ext4 filesystem has no usable space while an administrator sees blocks that appear free. Ext4 can reserve blocks for privileged allocation. That reserve is part of filesystem policy, so total unallocated space and space available to a particular writer are not always the same quantity.
This guide addresses reserved capacity, not every possible cause of a failed write. Begin with the exact path, filesystem type and service identity. Have the storage owner confirm whether the filesystem serves the operating system or dedicated application data. The inspection commands are read-only; changing reserved capacity requires an explicit space-management decision.
Identify and quantify the reserve
- Run
findmnt -T /path/to/datafor the real application path and confirm that the backing filesystem is ext4. Follow the mapping through any encrypted or logical-volume layer. Do not run ext-family tuning tools against a device selected merely because its size looks familiar. Capturedf -hfor the same mount and record the failing writer. - Use
sudo tune2fs -l /dev/verified-deviceto inspect the confirmed filesystem. Record block size, block count, reserved block count and reserved user/group identifiers. Multiply reserved blocks by block size to understand the approximate reserved quantity. Perform the calculation in your working notes rather than copying a percentage from another server. - Compare available capacity with the service's required headroom and growth rate. Review retention, batch peaks and the impact of a full filesystem on essential daemons. A large dedicated data volume and a small operating-system root filesystem can need different reserve policies. The correct choice follows their roles, not a universal recommendation to remove every reserve.
An illustrative capacity misunderstanding
In an illustrative media server, a nonprivileged processing account cannot create another output file near capacity. An administrator can still write a small diagnostic file because reserved allocation is available. Granting the application elevated privileges would defeat the intended boundary and still leave the growth problem. The team reviews retention and the dedicated volume's reserve policy with the storage owner instead.
| Observation | Diagnostic check | Interpretation |
|---|---|---|
| Admin write works, service write fails | Writer identity and reserved policy | Privileged reserve may matter |
| Large difference in free and available | Reserved block count and block size | Quantify the policy allocation |
| Reserve already small, growth continues | Workload and retention trend | Capacity problem remains |
| Filesystem is not ext4 | Verified filesystem type | Use its own supported tools |
Correct the policy and the growth problem
If reserve adjustment is justified, document the previous value, expected released capacity and reason for preserving any remaining reserve. Use the installed filesystem tool's supported options through the change process. Avoid changing unrelated filesystem features while addressing available capacity; feature changes can introduce separate compatibility requirements.
Also correct the cause of unexpected growth or provision measured capacity. Reducing a reserve changes who may allocate existing blocks; it does not add storage. Preserve essential system-writing headroom and consider the consequence of allowing an application to consume the last ordinary available space.
Verify the reported available capacity and a harmless write through the actual service identity. Confirm expected application cleanup and ordinary daemon operation. Review the capacity trend after a representative workload period so an emergency adjustment does not become the long-term storage plan.
Keep reserve policy visible
Document filesystem role, reserve owner, service writer and capacity escalation thresholds. Monitor space available to the workload alongside total size and growth. Include reserve review when new filesystems are built. Clouvenix Linux administration can help make capacity policy consistent with server operations.
Technical reference
tune2fs reserve documentation and ext4 filesystem reference.