sodcalculator

10 Tech How-To

Fix Corrupt User Accounts on macOS

Guide 10-44820 · Updated · Step by step

If your Mac shows a login loop, missing files, or a user that won’t load properly, the account’s preference files or permissions are likely corrupt. The fix is to boot into Recovery Mode and use the built-in tools to reset permissions or recreate the account, and in most cases you can keep your data.

What “Corrupt User Account” Means on macOS

A user account on macOS is more than just a name and password. It includes a home folder (/Users/yourname) with Library folders, preference files (.plist), caches, and a set of permissions tied to a unique user ID (UID). When any of these become damaged—often from a crash during login, a failed software update, or a disk error—the system may not recognize the account as valid. Symptoms range from being stuck at the login screen after entering your password, to the desktop appearing but apps crashing immediately, to the account simply not showing in System Settings.

It’s important to distinguish a corrupt account from a corrupt disk. If the disk itself has errors, the fix is different (Disk Utility First Aid). If only the account is broken, you can often repair it without erasing anything.

Before You Start: Backup and Safe Mode

Before making any changes, back up your data if you can. If you can’t log in to back up normally, you can still use Time Machine from Recovery Mode or connect an external drive and copy files via Terminal in Recovery. Never skip this step if the data matters to you.

Then try Safe Mode. Shut down your Mac, then turn it on and immediately press and hold the Shift key until the login window appears. Safe Mode forces a directory check, disables login items, and clears some caches. Log in with the problem account. If it works, restart normally. If the problem is gone, it was likely a cache or a third-party login item, not a deep corruption.

Step-by-Step: Repair Permissions and Caches

If Safe Mode doesn’t fix it, the next step is to repair the account’s permissions and caches. macOS has a built-in tool called Disk Utility that can repair disk permissions (on older macOS versions) and, more importantly, check the disk’s structure. But for user-level corruption, the most effective method is to delete the problematic preference files and caches.

  1. Boot into Recovery Mode: Shut down your Mac, then press and hold the power button (on Apple Silicon) or Command-R (on Intel) until you see the startup options.
  2. Open Terminal from the Utilities menu.
  3. If you know the account’s short name (e.g., john), you can navigate to its home folder: cd /Volumes/YourDisk/Users/john (replace YourDisk with your startup volume’s name).
  4. Rename the Library folder to Library.old: mv Library Library.old. This forces macOS to create a fresh Library on next login, discarding all corrupt preference files.
  5. Restart normally and log in. Your documents, Desktop, and Downloads remain intact; only settings and app data in the old Library are hidden. If the account works, you can later copy specific items from Library.old back.

If the account still doesn’t load, the problem may be deeper, and you may need to reset the account’s password or permissions using the resetpassword tool (available in Recovery on older macOS) or the dscl command.

Recreate the Account (Keep Your Files)

If the account is beyond repair, the reliable fallback is to create a new administrator account and then reassign your home folder to it. This avoids the “user already exists” error that happens if you try to create an account with the same name.

  1. In Recovery Mode, open Terminal and run rm -rf /Volumes/YourDisk/var/db/dslocal/nodes/Default/users/yourname.plist to delete the corrupted account record. (Make sure you have a backup first.)
  2. Restart and create a new account with the same short name via System Settings > Users & Groups.
  3. When asked, do not create a new home folder; instead, after the account is created, log out and log into the new account. Then go to System Settings > Users & Groups, right-click the account, and choose “Advanced Options.” Change the home directory to point to your original folder (/Users/yourname).
  4. Restart. The new account should now use your original files.

This method works for most cases, but if the home folder itself has corrupt ACLs (access control lists), you may need to run sudo chown -R yourname:staff /Users/yourname from Terminal after logging in.

Common Mistakes and Misconceptions

A frequent misunderstanding is that resetting the password via Recovery Mode will also fix a corrupt account. It won’t; it only changes the password. Another is that deleting the home folder is necessary—it almost never is. You can always preserve files.

Another common error is trying to fix permissions with Disk Utility > First Aid on a running system. That only checks the file system structure, not user permissions. For user permissions, you need Terminal commands like chown and chmod.

Also, be aware that on Apple Silicon Macs, the Recovery Mode interface looks different (it shows a window with options), but the Terminal and Disk Utility tools are the same. Don’t confuse Recovery Mode with the startup disk selection screen.

When to Use the Erase Option (and When Not To)

If the account corruption is accompanied by widespread system instability—constant kernel panics, inability to boot even into Safe Mode, or the disk failing First Aid—then a clean reinstall of macOS may be the only option. But this is a last resort. Before erasing, try the following:

  • Run First Aid on the startup volume from Recovery Mode.
  • Try booting into an external drive or another volume to see if the problem follows the account or the hardware.
  • If you have a Time Machine backup, you can restore just the home folder after reinstalling.

If you do erase, you’ll lose all data on that volume, so only do it after you’ve exhausted other options and have a backup.

Prevention: How to Avoid Future Corruption

Most account corruption comes from sudden power loss during writes, failed software updates, or third-party utilities that modify system files. To reduce the risk:

  • Always shut down properly, not by holding the power button.
  • Keep your Mac plugged in during macOS updates.
  • Avoid force-quitting the login window or Finder.
  • Use Time Machine or another backup so you can restore quickly.
  • Periodically run First Aid on your disk (monthly is reasonable).

Also, if you use FileVault, ensure you know your recovery key; a corrupt account combined with a lost key can make data recovery impossible.

Frequently Asked Questions

Will I lose my files if I delete the user account? No, if you only delete the account record (the .plist file), your home folder remains on disk. You can then create a new account and point it to that folder. If you choose “Delete Home Folder” during account deletion, then yes, files are gone—so never select that option if you want to keep data.

Why does my Mac keep asking for my password after I enter it correctly? This is a classic sign of a corrupt login keychain or a corrupted user record. The system can’t read your keychain to unlock the login session. Renaming the Library folder (as above) often fixes it, or you can reset the login keychain via Keychain Access in Recovery.

Can I fix a corrupt user account without erasing my Mac? Yes, in most cases. The steps above (Safe Mode, renaming Library, recreating the account) avoid a full erase. Only severe disk damage or system file corruption requires a reinstall.

What’s the difference between resetting the password and repairing the account? Resetting the password only changes the authentication credential. It doesn’t touch the account’s preference files, permissions, or keychains. Repairing involves fixing those underlying structures, which is what actually resolves login loops and missing settings.

Is there a way to recover data from a corrupt account if I can’t log in? Yes. Boot into Recovery Mode, open Terminal, and copy files from the home folder to an external drive using cp or rsync. You can also use the “Utilities > Migration Assistant” after reinstalling macOS to pull data from a Time Machine backup.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →