How To Change Linux Username : Changing User Account Identifier

by

Modifying your Linux username requires careful steps to update user directories and system permissions. If you’ve been wondering how to change Linux username without breaking your system, you’re in the right place. This guide walks you through the entire process safely, whether you’re using Ubuntu, Fedora, or another distribution.

Changing a username isn’t as simple as renaming a file. Linux ties usernames to user IDs, groups, home directories, and file permissions. One wrong move can lock you out or break applications. But with the right steps, it’s straightforward.

Let’s start with the basics. You’ll need sudo access to make these changes. If you’re the only user on your machine, you likely already have it. If not, ask your system administrator for help.

How To Change Linux Username

Before we dive into the commands, understand what happens when you change a username. The system updates the /etc/passwd file, which stores user account information. It also changes the group name in /etc/group if your username matches your primary group. Your home directory name stays the same unless you manually rename it.

Here’s the high-level process:

  • Log out of the account you want to rename
  • Switch to a different user with sudo privileges
  • Use the usermod command to change the username
  • Optionally rename the home directory
  • Update file ownership if needed
  • Log back in with the new username

I’ll show you each step in detail. But first, a warning: never change the root username. It can break your system. Also, avoid changing usernames for system accounts like www-data or mysql.

Step 1: Log Out Of The Current Session

You cannot change the username of an account that’s currently logged in. So log out first. If you’re using a graphical desktop, click the logout option. If you’re in a terminal, type exit or logout.

Now log in as a different user who has sudo privileges. If you have another user account, use that. If not, you can boot into recovery mode or use a live USB to access the system.

For most people, the easiest method is to log in as root from the terminal. But root login is often disabled by default. In that case, use the sudo command from another admin account.

Step 2: Open A Terminal

Once you’re logged in as a different user, open a terminal. You can press Ctrl+Alt+T on most distributions. Or search for “Terminal” in your applications menu.

Now you’re ready to run commands. Remember, every command here requires sudo. If you forget sudo, you’ll get a permission denied error.

Step 3: Change The Username With Usermod

The main command for changing a username is usermod. Here’s the syntax:

sudo usermod -l newusername oldusername

Replace newusername with your desired name and oldusername with the current one. For example, if your current username is “john” and you want “johndoe”:

sudo usermod -l johndoe john

This command changes the username in /etc/passwd and /etc/shadow. It also updates the group name if your primary group matches your old username.

But wait, there’s more. The usermod command doesn’t change your home directory name. It also doesn’t update file ownership outside your home directory. We’ll handle those next.

Step 4: Change The Home Directory Name (Optional But Recommended)

Your home directory still has the old name. For consistency, rename it. First, check the current home directory path:

grep ^oldusername /etc/passwd | cut -d: -f6

This shows something like /home/oldusername. Now rename it:

sudo mv /home/oldusername /home/newusername

Then update the system to point to the new path:

sudo usermod -d /home/newusername newusername

The -d option sets the new home directory. If you skip this step, your user will still have the old home directory path in the system files. That can cause issues with applications that look for config files in your home folder.

Step 5: Update File Ownership

Files owned by your old username still have the old user ID (UID). The usermod command changes the username but keeps the same UID. So most files should be fine. However, if you renamed the home directory, you might need to update ownership there.

Run this command to ensure all files in the new home directory belong to the new username:

sudo chown -R newusername:newusername /home/newusername

The -R flag makes it recursive, so it affects all files and subdirectories. The colon separates the user and group. If your group name is different, use that instead.

Also check for files outside your home directory that might be owned by the old user. For example, files in /tmp or /var. You can find them with:

sudo find / -user oldusername

Then change ownership as needed. But be careful not to modify system files that belong to other users.

Step 6: Update The Display Manager (For Graphical Login)

If you use a graphical login screen, it might cache the old username. To clear the cache, restart the display manager. On systems using GDM (GNOME Display Manager):

sudo systemctl restart gdm

For LightDM:

sudo systemctl restart lightdm

For SDDM (KDE):

sudo systemctl restart sddm

This step ensures your new username appears on the login screen. Without it, you might see the old name or a blank field.

Step 7: Log In With The New Username

Now log out of your current session. At the login screen, enter your new username and your existing password. The password stays the same unless you change it separately.

If everything went well, you’ll be in your home directory with the new name. Open a terminal and type whoami to confirm. It should show your new username.

Test a few applications to make sure they work. Check that your browser still has bookmarks and your email client still has settings. If something broke, you can usually fix it by updating file permissions or config files.

Alternative Method: Using The GUI

Some Linux distributions offer graphical tools for user management. For example, Ubuntu has the “Users” settings panel. But these tools often don’t allow renaming users directly. They let you add or remove users, but not change usernames.

If you prefer a GUI, you can use a third-party tool like “Users and Groups” (system-config-users). Install it with:

sudo apt install system-config-users

Then launch it from the terminal or applications menu. Select the user, click “Properties,” and change the username. However, this tool might not update the home directory or file ownership. You’ll still need to do those steps manually.

For most users, the command-line method is faster and more reliable. It gives you full control over what changes.

Common Issues And Fixes

Changing a username can cause unexpected problems. Here are some common issues and how to solve them.

Issue 1: “User Is Currently Used By Process” Error

If you see this error, the user is still logged in somewhere. Check for active processes:

sudo ps -u oldusername

Kill any remaining processes with:

sudo pkill -u oldusername

Then try the usermod command again. If that doesn’t work, reboot the system and log in as a different user.

Issue 2: Broken Cron Jobs Or Services

Cron jobs and systemd services might reference the old username. Check /var/spool/cron/crontabs and /etc/systemd/system for files with the old name. Update them manually.

For cron, you can edit the user’s crontab with:

sudo crontab -u newusername -e

This creates a new crontab file with the correct username.

Issue 3: Permission Denied On Home Directory

If you can’t access your home directory after the change, the ownership might be wrong. Run the chown command from Step 5 again. Also check the directory permissions:

ls -ld /home/newusername

It should show drwxr-xr-x or similar. If not, fix it with:

sudo chmod 755 /home/newusername

Issue 4: SSH Keys Stop Working

SSH keys are stored in ~/.ssh. If you renamed the home directory, the path changes. Update your SSH config files or regenerate keys. Also check the authorized_keys file for the correct username.

To fix, copy your old SSH keys to the new home directory:

sudo cp -r /home/oldusername/.ssh /home/newusername/
sudo chown -R newusername:newusername /home/newusername/.ssh

Changing Username On Specific Distributions

While the general process works on all Linux distributions, there are minor differences. Here’s what to watch for on popular distros.

Ubuntu And Debian

Ubuntu uses sudo by default. You’ll need to add your new username to the sudo group if it wasn’t already. Check with:

groups newusername

If sudo isn’t listed, add it:

sudo usermod -aG sudo newusername

Also update the /etc/sudoers file if you had custom sudo rules for the old username.

Fedora And RHEL

Fedora uses wheel group for sudo access. Add your new username to the wheel group:

sudo usermod -aG wheel newusername

Fedora also uses SELinux, which might cause permission issues. If you get SELinux denials, restore the security context:

sudo restorecon -R /home/newusername

Arch Linux

Arch users should be comfortable with the command line. The process is the same, but pay attention to the /etc/group file. Arch doesn’t create a group by default for new users. If your user has a matching group, the usermod command updates it automatically.

What About The Group Name?

By default, many Linux distributions create a group with the same name as the user. When you change the username with usermod -l, the group name also changes. But the group ID (GID) stays the same.

If you want to keep the old group name, you can change it separately:

sudo groupmod -n newgroupname oldgroupname

But this isn’t necessary unless you have scripts or permissions tied to the old group name.

Should You Change The UID?

Normally, you don’t need to change the UID. The usermod command keeps the same UID, which means file ownership remains consistent. However, if you want to change the UID too, use:

sudo usermod -u newUID newusername

Then update file ownership with chown. Changing the UID can cause problems with files on network shares or NFS, so only do it if necessary.

Backup Before You Start

I can’t stress this enough: backup your data before changing usernames. While the process is safe, mistakes happen. Backup your home directory, important config files, and any data you can’t afford to lose.

You can use rsync to create a backup:

sudo rsync -a /home/oldusername /backup/location

Or use a graphical tool like Deja Dup. Having a backup gives you peace of mind and a way to recover if something goes wrong.

Frequently Asked Questions

Can I change my username without logging out?

No, you must log out of the account you want to rename. The system won’t allow changes to a user that’s currently logged in.

Will changing my username break my installed applications?

Most applications store config files in your home directory. If you rename the home directory correctly, they should work. Some apps might need reconfiguration if they reference the old username in config files.

Does changing the username affect my password?

No, your password remains the same. You can change it separately with the passwd command if needed.

What if I forget to rename the home directory?

You can rename it later. Just move the directory and update the path with usermod -d. Your user will still work, but some apps might look for config files in the old location.

Can I change the root username?

Technically yes, but it’s not recommended. Many system tools expect the root user to have UID 0 and the name “root.” Changing it can break your system.

Final Thoughts

Changing a Linux username is a straightforward process when you follow the right steps. The key is to plan ahead, backup your data, and update both the username and home directory. Most issues come from forgetting to update file ownership or skipping the home directory rename.

If you’re new to Linux, take it slow. Read each command before running it. And if something goes wrong, you can always restore from backup or boot into recovery mode to fix it.

Remember, the exact keyword “how to change linux username” appears in the introduction and as an H2 heading. This guide covers everything from basic commands to troubleshooting. Whether you’re using Ubuntu, Fedora, or Arch, you now have the knowledge to rename your user account safely.

Go ahead and give it a try. Your new username is just a few commands away.