Fixing com.apple.launchd peruser Crash Loop on macOS

Symptoms

Users experience repeated pop-up notifications stating that com.apple.launchd (peruser) has crashed or is in a crash loop. The system may become sluggish, unresponsive, or show high CPU usage from launchd processes. In some cases, apps fail to launch or the system freezes intermittently.

Root Causes

The com.apple.launchd peruser crash loop typically occurs due to one or more of the following:

• Corrupted user launchd plist files in ~/Library/LaunchAgents/
• Third-party software that installs incompatible launch agents
• System file corruption after an incomplete macOS update or upgrade
• Permissions issues on user-specific launchd configuration files
• Conflicts between user-level and system-level launch daemons

Step-by-Step Fix

1. Boot into Safe Mode

1. Shut down your Mac completely.
2. Press the power button and immediately hold the Shift key.
3. Release the key when the login window appears (you may need to log in twice).
4. In Safe Mode, launchd loads only essential system services. If the crash stops, a third-party launch agent is likely the cause.

2. Remove Corrupted User Launch Agents

1. Open Terminal (from /Applications/Utilities/).
2. Navigate to your LaunchAgents folder: cd ~/Library/LaunchAgents/
3. List all files: ls -la
4. Move suspicious plist files to a backup folder (e.g., Desktop): mv com.suspect.plist ~/Desktop/
5. Restart normally and check if the crash loop persists.

3. Reset Launch Services Database

1. Open Terminal.
2. Run: /System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Support/lsregister -kill -r -domain local -domain system -domain user
3. Restart your Mac.

4. Repair Disk Permissions (macOS Catalina and earlier)

1. Boot into Recovery Mode (hold Cmd+R at startup).
2. Open Disk Utility from the Utilities menu.
3. Select your startup disk and run First Aid.
4. If using macOS Mojave or earlier, open Terminal in Recovery Mode and run: diskutil resetUserPermissions / `id -u`

5. Reinstall macOS

1. Back up your data using Time Machine or other method.
2. Boot into Recovery Mode (Cmd+R).
3. Select Reinstall macOS and follow the prompts. This preserves your files but replaces system files.

Alternative Fixes

• Create a new user account: If the crash only affects one user, create a new user via System Settings > Users & Groups. Transfer data and delete the old account.
• Use Activity Monitor: Identify which process is causing high launchd CPU usage by opening Activity Monitor, filtering by launchd, and force-quitting problematic sub-processes.
• Check system logs: Run log show --predicate 'process == "launchd"' --last 1h in Terminal to identify the specific plist file causing crashes.

Prevention

• Regularly update macOS to the latest version.
• Avoid installing unverified third-party software that adds launch agents.
• Periodically review ~/Library/LaunchAgents/ and remove obsolete plist files.
• Maintain regular backups to recover quickly from system corruption.
• Use a tool like EtreCheck to monitor system health and identify problematic launch daemons.

By following these steps, you can resolve the com.apple.launchd peruser crash loop and restore normal system operation.