To successfully change a user folder name on macOS is to have stared into that abyss, prepared a full Time Machine backup, booted into Recovery mode or a second admin account, and manually rewired the skeletal structure of your digital identity. It is not a trick. It is a test of whether you understand that in Unix, your name is not who you are—it is where you live .
sudo dscl . -change /Users/oldname RecordName oldname newname sudo mv /Users/oldname /Users/newname sudo dscl . -change /Users/newname NFSHomeDirectory /Users/oldname /Users/newname This works. But it works only if you are logged in as another admin user, with no processes belonging to the target user running. It requires a complete logout, a silent login as root or secondary admin, and a prayer. Why does this trivial operation feel so traumatic? Because in the Unix philosophy, a name is a pointer, not a label . When you name a baby, the name is a social construct; the baby persists regardless. But in a filesystem, the path /Users/john/Documents/resume.pdf is not a description of where the file lives—it is the file’s address in reality. Changing the path is not a rebranding; it is a relocation. mac change user folder name
Thus, the user is pushed toward the Terminal, armed with the canonical (but dangerous) three-step ritual: To successfully change a user folder name on
sudo ln -s /Users/newname /Users/oldname Or, even more elegantly, use an APFS firmlink (Apple’s hidden solution for /System/Volumes/Data ). But this is a palliative, not a cure. You are now maintaining a ghost. Your shell says newname , but every log file, every crash report, and every dscl query still whispers oldname in the dark. The command sudo mv /Users/oldname /Users/newname is deceptively short. It contains no warnings. It does not ask, “Are you sure?” It simply executes. And in that silence lies the essence of system administration: the understanding that a filesystem is a deterministic machine, indifferent to your desire for a cleaner, more accurate username. sudo dscl