Fixing com.apple.launchd peruser Crash Loop on macOS
The com.apple.launchd peruser error indicates a crash loop in macOS's per-user launchd process, often caused by corrupted user plist files or system launch agents. This guide provides step-by-step fixes to resolve the crash and prevent recurrence.
Symptoms
Users experience repeated system freezes, unresponsive apps, or frequent restarts. The console log shows repeated entries like com.apple.launchd.peruser.501 (where 501 is the user ID) with exit codes indicating crashes. The system may become sluggish or completely lock up.
Root Causes
The peruser launchd process manages user-level daemons and agents. Common causes include:
- Corrupted or misconfigured user plist files in
~/Library/LaunchAgents - Faulty third-party launch agents (e.g., from Adobe, Dropbox, or antivirus)
- Damaged system launchd database or permissions
- Conflicts after macOS updates or migrations
- Rare hardware or kernel issues causing process instability
Step-by-Step Fix
1. Boot into Safe Mode
Safe Mode disables user launch agents and clears caches. On Apple Silicon Macs, shut down, hold the power button until Loading startup options appears, select your disk, hold Shift, and click Continue in Safe Mode. On Intel Macs, restart and hold Shift immediately. Log in and check if the crash stops. If it does, proceed to step 2.
2. Identify Problematic Launch Agents
Open Terminal and run:
sudo launchctl list | grep -E 'com.apple.launchd.peruser|PID|exit'Look for processes with high restart counts. Also check ~/Library/LaunchAgents and /Library/LaunchAgents for recently added plists. Temporarily move suspect plists to a backup folder:
mkdir ~/Desktop/plist_backup
mv ~/Library/LaunchAgents/suspect.plist ~/Desktop/plist_backup/3. Reset Launch Services Database
Run in Terminal:
sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.launchd.plist
sudo launchctl load -w /System/Library/LaunchDaemons/com.apple.launchd.plistThis reloads the main launchd. Then reboot.
4. Repair Disk Permissions (macOS Catalina and earlier)
For older macOS, use Disk Utility First Aid or Terminal:
sudo /usr/libexec/repair_packages --repair --standard-pkgs /For modern macOS (Big Sur+), permissions are protected by System Integrity Protection (SIP).
5. Reset NVRAM and SMC
On Intel Macs, reset NVRAM: shut down, then press Option + Command + P + R for 20 seconds. Reset SMC: for T2 chips, hold Control + Option + Shift (right side) for 7 seconds, then press power. On Apple Silicon, these resets are automatic.
Alternative Fixes
- Create a new user account – If the crash only affects one user, migrate data to a new account.
- Reinstall macOS – Use Recovery Mode to reinstall the OS without erasing data.
- Check for malware – Use Malwarebytes or similar to scan for malicious launch agents.
Prevention
- Regularly update macOS and third-party apps.
- Audit launch agents periodically using
launchctl list. - Back up plist files before making changes.
- Avoid installing unnecessary daemons or agents from untrusted sources.
By following these steps, you can resolve the launchd peruser crash loop and restore system stability.
Was this solution helpful?