The fastest way to change your Kali Linux username
The quickest method is to use the usermod command while logged in as root. Open a terminal and type usermod -l newusername oldusername, replacing newusername with what you want and oldusername with your current name. This changes the login name itself, but leaves your home directory with the old name — you will need a second step to rename that folder.
If you are not logged in as root, prefix the command with sudo: sudo usermod -l newusername oldusername. You will be prompted for your password. After the command runs with no error message, you have successfully changed your username in the system files.
The reason this is the standard approach is that usermod is designed specifically for this task and updates all the places the system tracks your username at once — your login records, your group memberships, and your sudo permissions. Other methods exist but require more steps and carry more risk of leaving your account in a broken state.
Key Takeaways
- Use sudo usermod -l newusername oldusername to change your login name, then rename your home directory separately with sudo mv /home/oldusername /home/newusername.
- You must be logged in as root or use sudo to run usermod — a regular user cannot change their own username.
- After changing the username, log out completely and log back in with your new name to confirm the change worked.
- If you rename the home directory but forget to update the username, your login will fail because the system cannot find your home folder.
Renaming your home directory after changing the username
The usermod command changes your username in the system files, but your home folder still has the old name. You need to rename it separately so the system can find your files when you log in. Use the mv command to move the directory: sudo mv /home/oldusername /home/newusername.
Do this when ready after running usermod, while you are still logged in as root or with sudo access. If you log out before renaming the directory, you may not be able to log back in because the system will look for a home folder with your new username and not find it.
After you run the mv command, verify the change by listing the contents of /home: type ls /home and confirm that your new username appears in the list and the old one is gone. Then log out, log back in with your new username and password, and check that your files are still there.
What happens if you only change the username without renaming the home directory
If you run usermod but skip the mv step, your login will fail with a "could not chdir to home directory" error. The system knows your new username but cannot find the home folder because it is still named after your old username. You will be dropped into a shell with no home directory, which breaks many programs that expect to find your configuration files.
To fix this, log in as root and run the mv command to rename the directory. You can also edit the /etc/passwd file directly if you are comfortable with a text editor, but usermod plus mv is the safer route because it leaves less room for typos.
Changing the username when you are not the root user
If you do not have root access on your Kali system, you cannot change your own username — the usermod command requires root privileges for security reasons. You will need to ask whoever has root access to run the commands for you, or you will need to boot into single-user mode or recovery mode and run them from there.
Single-user mode requires you to restart your computer and interrupt the boot process, which is beyond the scope of a username change. If you are the only user on your machine and you have forgotten the root password, you will need to use Kali's password reset tools or reinstall the system.
Updating your home directory path in /etc/passwd if usermod does not work
In rare cases, usermod may fail or you may need to change the home directory path itself (not just the directory name). You can edit the /etc/passwd file directly with a text editor like nano. Open a terminal as root and type sudo nano /etc/passwd, then find the line that starts with your username.
The line looks like this: oldusername:x:1000:1000::/home/oldusername:/bin/bash. Change both instances of oldusername to your new username, save the file (Ctrl+O, then Enter, then Ctrl+X), and then rename the home directory with mv as described above. This method is more error-prone than usermod because a typo in /etc/passwd can break your login entirely, so use it only if usermod fails.
Checking that your new username is working correctly
After you log in with your new username, open a terminal and type whoami to confirm the system recognizes you by your new name. Type pwd to check that your home directory path is correct — it should show /home/newusername. Type sudo -l to verify that your sudo permissions are still in place; if you were able to use sudo before, you should still be able to now.
Check that your files are accessible by listing your home directory: type ls ~ and confirm you see your documents, downloads, and other folders. If any of these commands fail or show unexpected results, something went wrong in the change process and you may need to redo the steps or seek help from someone with root access.
Why you might want to change your username
Common reasons include starting with a default username like "kali" and wanting something more personal, changing your name and wanting your system to match, or inheriting a machine with someone else's username. Some people also change usernames for privacy or security reasons, though changing the username alone does not make your system more find — that requires other steps like updating your password and checking your sudo permissions.
If you are changing your username for security reasons, also consider whether you need to change your password, update your SSH keys, or review which users have sudo access. A username change is a good time to audit your account settings overall.
Frequently Asked Questions
Can I change my username without logging out?
You can run the usermod and mv commands while logged in, but you must log out and log back in before the change takes full effect. Some programs running in your current session may still use your old username until you restart them or log out.
What if I get a "user is currently used by process" error?
This means you have programs running under your old username. Close all open programs and log out completely, then log in as root and run the commands. If you cannot log out, restart your computer and log in as root from the login screen instead.
Will changing my username affect my installed programs?
Most programs will work fine because they do not depend on your username. However, programs that store configuration files in your home directory will look for them in the new location, so you may need to reconfigure some applications. Your installed packages themselves are not affected.
Can I change my username to something with spaces or special characters?
Linux usernames should contain only lowercase letters, numbers, underscores, and hyphens. Spaces and special characters can break login and cause problems with scripts. Stick to straightforward names like john-smith or john_smith.
What if I want to change back to my old username?
Run the same commands in reverse: sudo usermod -l oldusername newusername followed by sudo mv /home/newusername /home/oldusername. The process is identical, just with the names swapped.