FreeBSD 14 – Memory Pressure Triggers Swap Thrashing – Capacity and Tuning Fix

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

System responsiveness collapses due to constant paging and swap churn.

Environment & Reproduction

Frequent on oversubscribed VMs or memory-leaking daemons.

swapinfo -h
vmstat 1 10

Root Cause Analysis

Working set exceeds physical memory and aggressive allocations trigger page churn.

Quick Triage

Find top memory consumers and reduce immediate memory footprint.

top -o res
procstat -v  | head

Step-by-Step Diagnosis

Measure page fault rates and correlate with workload spikes.

systat -vmstat 1
sysctl vm.stats.vm

Solution – Primary Fix

Tune service memory limits, add swap if needed, and restart leaking components.

swapoff -a 2>/dev/null || true
swapon -a
service  restart

Solution – Alternative Approaches

Scale out workload or increase RAM allocation for sustained peaks.

Verification & Acceptance Criteria

Page fault and swap-in rates return to acceptable baseline levels.

vmstat 1 10
swapinfo -h

Rollback Plan

Revert tuning changes if application behavior worsens after memory adjustments.

Prevention & Hardening

Alert on swap growth and enforce per-service memory guardrails.

Related Errors & Cross-Refs

system sluggish, OOM-like kills, high page daemon activity.

Related tutorial: View the step-by-step tutorial for freebsd-14.

View all freebsd-14 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

FreeBSD VM subsystem tuning and memory diagnostics docs.