rc.local Script Not Executing at Boot

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

Legacy startup logic in rc.local may not run on RHEL 7 when rc-local service is disabled or script permissions are wrong.

Environment & Reproduction

Custom boot commands never execute, leaving mount, routing, or initialization tasks incomplete after reboot.

Root Cause Analysis

Missing executable bit, invalid interpreter line, rc-local compatibility service disabled, or script errors at runtime.

Quick Triage

Verify systemctl status rc-local, service rc.local status where available, and inspect script path and permissions.

Step-by-Step Diagnosis

Read journalctl -u rc-local and boot logs to locate script parse failures or unit activation skips.

Solution – Primary Fix

Confirm rc.local shebang, executable mode, and command validity in the script body before enabling service.

Solution – Alternative Approaches

Fix script format, set executable permission, enable rc-local unit, reboot or start manually, and verify command effects.

Verification & Acceptance Criteria

SELinux labels on rc.local and called scripts must be valid; firewalld rules may be needed for network commands executed there.

Rollback Plan

Validate expected post-boot state and ensure rc-local logs show successful completion without repeated failures.

Prevention & Hardening

Disable rc-local and revert to systemd-native units if script behavior remains unreliable.

Related Errors & Cross-Refs

Migrate persistent boot logic to explicit systemctl-managed units with dependencies and error handling.

Related tutorial: View the step-by-step tutorial for rhel-7.

View all rhel-7 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Use RHEL systemd migration guidance to replace legacy rc.local usage safely.