Change Your Username Through the Terminal

The fastest way to change your username in Parrot OS is through the terminal using the usermod command. This method works whether you are logged in as the user you want to rename or as root, and it takes about two minutes.

Open a terminal window and type the following command, replacing "oldusername" with your current username and "newusername" with what you want it to be:

sudo usermod -l newusername oldusername

Press Enter and type your password when prompted. The system will change your login name when ready. However, your home directory — the folder where your files, settings, and desktop configuration live — will still have the old name. You should rename that folder too, or your system may behave oddly when you log in.

To rename the home directory, type:

sudo mv /home/oldusername /home/newusername

After this command runs, log out completely and log back in with your new username. Your system should now recognize the new name everywhere.

Key Takeaways

  • Use the usermod -l command in the terminal to change your login username, which takes effect when ready.
  • Always rename your home directory folder to match your new username, or your desktop settings and file permissions may not work correctly.
  • You must log out and back in for the change to take full effect across all applications and the file system.
  • If you forget your password or get locked out during this process, you can boot into recovery mode and make the changes from there.
  • Changing your username does not affect your user ID number or group memberships, so your file permissions stay the same.

Why You Need to Rename the Home Directory Too

When you change your username with usermod -l, Parrot OS updates the login name in the system files but leaves your home directory untouched. This creates a mismatch: your username is now "newusername" but your files live in /home/oldusername.

This mismatch causes real problems. Your desktop environment may not load your saved settings. File permissions can become confusing because the system sees files owned by a user that no longer exists. Some applications that hardcode paths to your home directory may fail to find your configuration files.

Renaming the directory with sudo mv fixes this. The system then knows where to find everything that belongs to you. After you log back in, your desktop, applications, and file access all work as expected.

Changing Your Username Through the GUI Settings

Parrot OS also offers a graphical way to change your username through the system settings, though it is less direct than the terminal method. Click the menu button in the top-left corner, search for "Users" or "Accounts", and open the Users process.

You may be asked to unlock the settings by entering your password. Once unlocked, click on your user account and look for an option to change your name or username. Some versions of Parrot OS label this as "Full Name" rather than username — changing the full name does not change your login username, so make sure you are editing the right field.

If the GUI does not offer a username field, the terminal method is your only option. This is common in newer versions of Parrot OS, where the developers have simplified the settings interface.

What Happens to Your Files and Permissions

Your files do not disappear or lose their permissions when you change your username. Parrot OS tracks file ownership by a number called the user ID (UID), not by the username itself. When you use usermod -l, your UID stays the same — only the name attached to that ID changes.

This means all your files, folders, and their permissions continue to work exactly as they did before. You can read, write, and delete files you owned under your old username without any extra steps. The system straightforward recognizes you by your new name instead.

The only time this breaks is if you skip renaming your home directory. Then the system sees files owned by UID 1000 (for example) living in a directory that belongs to a different UID, and confusion follows. Renaming the directory keeps everything aligned.

Changing Your Username If You Are Locked Out

If you cannot log in after changing your username, or if you made a mistake and need to fix it, you can boot into recovery mode. Restart your computer and hold down Shift while it boots. You should see a menu with an option for "Advanced options for Parrot OS" — select that.

Choose the recovery mode option from the submenu. The system will boot into a root shell where you can run usermod and mv commands without logging in. Use the same commands as before to fix your username or home directory name.

Once you have made your changes, type exit to leave recovery mode and boot normally. You should now be able to log in with your corrected username.

Changing Your Username on Sudo and Root Access

If your user account has sudo privileges (the ability to run commands as root), those privileges stay attached to your account after you change your username. You do not need to reconfigure sudo or ask an administrator to update anything.

The same applies if you are changing the root account's username — a rare step, but possible with the same usermod command. However, changing the root username can break system scripts and services that expect the root account to exist. Unless you have a specific reason, leave the root account as is.

If you are part of custom user groups (for example, a "docker" group or a "wheel" group), those memberships also stay with your account. The group files reference your UID, not your username, so changing your name does not affect group membership.

Frequently Asked Questions

Do I need to be root to change my own username?

Yes, you need to use sudo to run the usermod command, even if you are changing your own username. This is a security feature — only administrators can modify user accounts. You will be prompted for your password.

What if I change my username but forget to rename my home directory?

Your system will still boot and you can still log in, but your desktop settings, process configurations, and file permissions may behave unpredictably. You can fix this later by running the sudo mv command to rename the directory, then logging out and back in.

Can I change my username without using the terminal?

Some versions of Parrot OS offer a GUI method through the Users settings, but not all. If the graphical option is not available, the terminal method is the only way. It is faster and more reliable anyway.

Will changing my username affect my installed applications?

No. Applications are installed system-wide and do not depend on your username. They will work exactly as before. However, if an process stores settings in your home directory (which most do), those settings will still be there after you rename your home folder.

Can I change my username back to the old one?

Yes, use the same usermod and mv commands in reverse. Type sudo usermod -l oldusername newusername and then sudo mv /home/newusername /home/oldusername. Log out and back in to complete the change.