com.apple.launchd.peruser
Fix com.apple.launchd.peruser Error Crash Loop on macOS
The com.apple.launchd.peruser error indicates a persistent crash loop in macOS's per-user launchd process, often caused by corrupted user plists or third-party launch agents. This guide provides step-by-step fixes to resolve the crash and restore system stability.
Symptoms
- Repeated pop-up or notification: 'com.apple.launchd.peruser' quit unexpectedly.
- System becomes sluggish or unresponsive.
- High CPU usage by launchd or related processes.
- Crash reports in Console app showing launchd.peruser repeated crashes.
- Applications may fail to launch or behave erratically.
Root Causes
- Corrupted user-specific launch agents: Plist files in
~/Library/LaunchAgentsthat are malformed or incompatible. - Third-party software: Applications that install faulty launch agents (e.g., outdated antivirus, system utilities).
- Incomplete macOS update: System files left in inconsistent state after an upgrade.
- User cache corruption: Cached data interfering with launchd operations.
- Permissions issues: Incorrect file permissions on user library folders.
Step-by-Step Fix
1. Identify the Problematic Launch Agent
- Open Console app (from /Applications/Utilities).
- Click on Crash Reports in the sidebar.
- Look for reports named
com.apple.launchd.peruser. Open the most recent one. - Scroll down to the Backtrace section. Note any references to specific plist files or bundle identifiers (e.g., com.thirdparty.agent).
2. Remove or Disable the Offending Agent
- Open Terminal.
- Navigate to user launch agents:
cd ~/Library/LaunchAgents - List files:
ls -la - If you identified a specific plist (e.g., com.thirdparty.agent.plist), remove it:
rm com.thirdparty.agent.plist - If unsure, temporarily move all plist files to a backup folder:
mkdir ~/Desktop/launchagents_backup mv *.plist ~/Desktop/launchagents_backup/ - Reboot your Mac.
3. Clear User Cache and Temp Files
- In Terminal, run:
rm -rf ~/Library/Caches/* rm -rf ~/Library/Logs/* rm -rf ~/Library/Preferences/com.apple.launchd* - Empty Trash and reboot.
4. Repair Disk Permissions (if applicable)
- For macOS Catalina and earlier: Boot into Recovery Mode (Cmd+R at startup), open Disk Utility, select your startup disk, and click First Aid.
- For macOS Big Sur and later: Run in Terminal:
Note: This command may not be available; use First Aid from Recovery instead.sudo diskutil repairPermissions /
5. Boot into Safe Mode
- Restart your Mac and hold the Shift key immediately after the chime.
- Release when you see the login window. Login (may require multiple attempts).
- Safe Mode loads only essential kernel extensions and disables user launch agents.
- If the crash does not occur in Safe Mode, the issue is with a third-party agent.
- Reboot normally.
Alternative Fixes
- Create a new user account: If the crash persists, the user profile may be corrupted. Create a new admin account via System Settings > Users & Groups, and migrate data.
- Reset NVRAM/PRAM: For Intel Macs: Shut down, then press Option+Cmd+P+R at startup for 20 seconds.
- Reinstall macOS: As a last resort, reinstall macOS from Recovery Mode without erasing your data.
Prevention
- Regularly update macOS and third-party software.
- Avoid installing untrusted applications that modify launch agents.
- Periodically review
~/Library/LaunchAgentsand remove unused plist files. - Use tools like EtreCheck to monitor system integrity.
- Maintain regular backups with Time Machine.
Was this solution helpful?