FreeBSD 12 – Common Problem 019 – Boot Delays or Hangs During Filesystem Check

📖 ~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

Reboots take excessively long or stop at filesystem check prompts.

Environment & Reproduction

Usually follows unclean shutdown, storage errors, or abrupt power loss.

Root Cause Analysis

Dirty UFS metadata or repeated fsck retries due to unresolved disk issues.

Quick Triage

Capture boot messages and identify affected filesystem.

dmesg -a | tail -n 120
cat /etc/fstab
geom disk list

Step-by-Step Diagnosis

Run manual checks from single-user mode on impacted devices.

fsck -fy /dev/ada0p2
smartctl -a /dev/ada0
glabel status

Solution – Primary Fix

Repair filesystem and correct mount options before returning multi-user mode.

fsck -fy
mount -uw /
reboot

Solution – Alternative Approaches

Migrate critical data to ZFS to reduce fsck dependency for large volumes.

Verification & Acceptance Criteria

System boots without fsck prompt and no new filesystem errors appear in logs.

Rollback Plan

Restore from snapshot/backup if filesystem remains inconsistent after repair.

Prevention & Hardening

Use clean shutdown policies, UPS protection, and regular SMART health checks.

Related Errors & Cross-Refs

`UNEXPECTED SOFT UPDATE INCONSISTENCY`, repeated fsck passes, boot timeout.

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

View all freebsd-12 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

`fsck(8)`, `fstab(5)`, FreeBSD storage troubleshooting docs.