Is there a portable way to get the current username in Python?

Question

What is a portable way (e.g. for Linux and Windows) to get the current user's username? Something similar to os.getuid() would be nice:

>>> os.getuid()
42

# Does not currently exist in Python
>>> os.getusername()
'slartibartfast'

The pwd module works for Unix only. Some people suggest that getting the username under Windows can be complicated in certain circumstances (e.g., running as a Windows service).

`import pwd, os; print pwd.getpwuid(os.getuid()).pw_gecos` or `import pwd, os; print pwd.getpwuid(os.getuid()).pw_name` — chown, Mar 01 '15 at 16:46
getusername() is not valid method in the os Python module: https://docs.python.org/2.7/library/os.html — Matt Bruzek, May 31 '16 at 18:25
@MattBruzek That was OP’s point there. He was imagining how such a function could be called if it existed. — poke, Jun 30 '16 at 06:51
"username" is not even a portable _concept_. Consider microPython -- if you're running directly on hardware there's no such thing. — Charles Duffy, Aug 01 '20 at 23:52

score 1054 · Accepted Answer · edited Apr 25 '22 at 00:36

1054

Look at getpass module

import getpass
getpass.getuser()
'kostya'

Availability: Unix, Windows

p.s. Per comment below "this function looks at the values of various environment variables to determine the user name. Therefore, this function should not be relied on for access control purposes (or possibly any other purpose, since it allows any user to impersonate any other)."

edited Apr 25 '22 at 00:36

Mateen Ulhaq

24,552
19
101
135

answered May 08 '09 at 22:30

Konstantin Tenzin

12,398
3
22
20

40

There is nothing wrong with getpass.getuser(), since does not claim to authenticate the user. The purpose of the function is to determine who the user is claiming to be without asking the user directly. – Walker Hale IV Oct 17 '11 at 03:47
9

That does not work if you've done a su. $ echo $USER hithwen $ su julia Password: $ echo $USER julia $ python >>> import getpass >>> getpass.getuser() 'hithwen' – hithwen Jan 23 '13 at 09:56
8

@GregHewgill raises a very good point, but indeed, finding out the username in a simple unauthenticated way like this does have some applications. My current use-case: tagging some shared testing resources with a username for easy cleanup later. (So it's easier to figure out whose mess is whose.) – floer32 Aug 16 '13 at 15:35
@hithwen What version are you using? In 2.7.4 your example works as expected for me. – nevelis Feb 26 '14 at 08:25
22

And I agree with @GregHewgill for the access control purposes, but completely disagree with 'any other purpose' - that's like saying "Don't use $USER in a shell script". Great point about access control but there are *plenty* of other uses that don't involve auth. – nevelis Feb 26 '14 at 08:27
3

@hithwen That's working as intended. It depends on which arguments you give to `su`. Perhaps you wanted to use `su - julia`. – kasperd Oct 27 '15 at 13:01
Doesn't work with sudo! To get the sudo user, I ended up using this: http://unix.stackexchange.com/a/137176/112190 – phyatt Aug 05 '16 at 17:40
Works on OSX too, at least as of Sept. 2016! – Delip Sep 17 '16 at 00:04
what if we have several users? – Dr. Younes Henni May 30 '18 at 15:25
Note that the `USER` variable isn't always set, e.g. in a container. However, I tested `getuser()` in Python 3.6.3 and 2.7.11 with `USER` unset, and it still works. – orodbhen Aug 14 '18 at 13:09
Make sure to `SET USERNAME=vmuser` if you're running a Windows VM provided by Microsoft because otherwise this won't work – Neil C. Obremski Apr 29 '20 at 15:41
@Dr.YounesHenni What do you mean? There is always only one user active at any time. – Jann Poppinga Jul 01 '20 at 14:40
@phyatt It works as intended. The user *is* root when you're running with sudo. If you want to get the user who called sudo, that's a different question. – alexia Nov 23 '21 at 14:45
getpass is part of the standard library. – theQuestionMan Feb 23 '22 at 16:03
plus 1 = 1000. Congrats :) – WinEunuuchs2Unix Jul 02 '22 at 16:21
This does not work reliably. Why? Because it will just read USER, USERNAME, LNAME, LOGUSER environment variables (check the source). Each of these can be overriden but there is still a "real" current user (e.g by invoking a subprocess running id -un) – IceFire Aug 07 '23 at 14:51
E.g. run `LOGNAME=dumb python -c "import getpass;print(getpass.getuser())"` – IceFire Aug 07 '23 at 14:54

score 164 · Answer 2 · edited May 31 '22 at 04:02

164

Combine os.getuid() with pwd.getpwuid():

import os
import pwd

def get_username():
    return pwd.getpwuid(os.getuid())[0]

See pwd docs for more details.

edited May 31 '22 at 04:02

Mateen Ulhaq

24,552
19
101
135

answered May 24 '10 at 17:53

Liam Chasteen

1,873
1
11
2

75

Alternatively (slightly nicer to read): `pwd.getpwuid(os.getuid()).pw_name`. – Brian M. Hunt Jun 21 '10 at 14:27
8

What does it do on Windows? Perhaps one could try this, and if it fails, fall back to the crappy 'getpass/env var' methods. – Jonathan Hartley Aug 02 '14 at 16:46
2

This is the correct way if you need to get the username both with and without logging in. – Derrick Zhang Dec 01 '14 at 11:41
9

@JonathanHartley: `ImportError: No module named pwd` – Justin May 26 '17 at 19:34
3

This method is on unix-like systems **much** superior to Konstantin Tenzin's answer, because it handles the `sudo` case correctly. (I am aware the OP didn';t ask for unix-like ssytems.) – halloleo Sep 10 '19 at 07:18
@halloleo When running with sudo, the expected behavior *is* for it to return `root`. That is by design and the other answers are not "wrong". You are simply asking for the answer to a different question. – alexia Nov 23 '21 at 14:47
3

Wrong answer -- this is NOT portable to Windows. – Stabledog Aug 02 '22 at 21:14

score 127 · Answer 3 · edited May 31 '22 at 04:04

127

You can also use:

os.getlogin()

edited May 31 '22 at 04:04

Mateen Ulhaq

24,552
19
101
135

answered Oct 20 '09 at 13:00

Marcin Augustyniak

1,351
1
8
2

39

On linux, getlogin() returns the name of the "user logged in on the controlling terminal of the process." It therefore fails when there is no controlling terminal, e.g., in a mod_python application. – Vebjorn Ljosa Nov 10 '09 at 23:56
8

If you used su, then this won't return the current user, but the originally logged in user. – Trevor Allred Sep 18 '14 at 17:26
5

does work on windows...Python 3.4.1 (v3.4.1:c0e311e010fc, May 18 2014, 10:38:22) [MSC v.1600 32 bit (Intel)] on win32 Type "help", "copyright", "credits" or "license" for more information. >>> import os; os.getlogin() 'jrb' – Naib Oct 22 '14 at 12:20
7

It's only available on Windows for Python 3.x. – Zitrax Sep 09 '15 at 12:37
3

Thanks for this. The login user is not exactly what the poster asked for but it is what I was looking for. – jorfus Mar 03 '16 at 19:20
On linux, `os.path.basename(os.listdir('/home')[0])` is more reliable across systems (e.g., desktop vs raspberry pi), assuming you are the only user of course. – Justapigeon Jan 06 '20 at 01:01
@WalkerHaleIV - what are you talking about?!? Yes it is! What isn't available is os.getuid. And pwd, at all. – Poke Jun 24 '20 at 13:55
On MacOS it is just giving me 'root' even though I am not logged in as root. – Christopher Barber Dec 15 '20 at 20:59

score 103 · Answer 4 · edited May 31 '22 at 04:48

103

Windows:

os.environ.get('USERNAME')

Linux:

os.environ.get('USER')

Both:

os.environ.get('USER', os.environ.get('USERNAME'))

Note that environment variables can be modified by the user, so this is a potential security vulnerability. With this method, an attacker can easily fake their username.

edited May 31 '22 at 04:48

Mateen Ulhaq

24,552
19
101
135

answered May 08 '09 at 22:35

Nadia Alramli

111,714
37
173
152

27

`os.getenv(...)` is deprecated in favour of `os.environ[...]`. – Mike Graham Feb 17 '11 at 12:12
12

Shouldn't it be USER instead of USERNAME? – Karl Bartel Sep 27 '12 at 12:58
10

@MikeGraham [`os.getenv`](http://docs.python.org/dev/library/os.html#os.getenv) doesn't seem to be deprecated..? – dbr Oct 02 '12 at 06:47
5

Yes, exactly USER vs USERNAME is exactly what is not portable, so it doesn't provide the correct answer. – Peter M Mar 07 '17 at 04:21
8

USERNAME is for Windows, USER is for Linux – Jan 03 '19 at 14:57
1

USER is not present for my test with PythonWin GUI window. – Alexander Stohr Jul 14 '20 at 14:47
1

@AlexanderStohr Exactly, therefore also `USERNAME` is queried in the expression. – gernot Dec 14 '22 at 20:19
just noted it down for illustrating how "complicated" a specific scenario assignment might turn out. – Alexander Stohr Dec 15 '22 at 17:09

score 25 · Answer 5 · edited May 31 '22 at 04:05

25

If you are needing this to get user's home dir, below could be considered as portable (win32 and linux at least), part of a standard library.

>>> os.path.expanduser('~')
'C:\\Documents and Settings\\johnsmith'

Also you could parse such string to get only last path component (ie. user name).

See: os.path.expanduser

edited May 31 '22 at 04:05

Mateen Ulhaq

24,552
19
101
135

answered Feb 09 '13 at 01:23

HezniK

275
3
2

12

Someone's home directory does not always reflect their username. – dreamlax May 06 '15 at 03:33
Unfortunately, if you set the HOME variable in Windows, this will return it that value. – GLRoman Apr 22 '20 at 22:00

score 25 · Answer 6 · edited Jul 29 '19 at 21:21

25

These might work. I don't know how they behave when running as a service. They aren't portable, but that's what os.name and ifstatements are for.

win32api.GetUserName()

win32api.GetUserNameEx(...)

See: http://timgolden.me.uk/python/win32_how_do_i/get-the-owner-of-a-file.html

edited Jul 29 '19 at 21:21

ncica

7,015
1
15
37

answered Jan 02 '10 at 21:35

Adam

338
3
3

38

This answer is at least as useful as the (useless) 25-vote upvoted unix-only answer. – Tom B Feb 14 '12 at 18:27
5

>"At least as useful" Agreed. Presumably the right answer is a combination of the two. – Jonathan Hartley Aug 02 '14 at 16:50
1

If you're stuck on python 2 on Windows, this is the only safe way to do it. All the other ways can be tricked by running ```SET USERNAME=FAKE``` before your python command – MathKid Jan 21 '19 at 17:22

score 17 · Answer 7 · 2013-12-05T14:47:08.550

17

To me using os module looks the best for portability: Works best on both Linux and Windows.

import os

# Gives user's home directory
userhome = os.path.expanduser('~')          

print "User's home Dir: " + userhome

# Gives username by splitting path based on OS
print "username: " + os.path.split(userhome)[-1]

Output:

Windows:

User's home Dir: C:\Users\myuser

username: myuser

Linux:

User's home Dir: /root

username: root

No need of installing any modules or extensions.

edited Dec 05 '13 at 14:47

answered Dec 05 '13 at 14:39

26

This solution is clever, but makes some assumptions that aren't always true. There is no constraint that requires the username to appear in the homedir path on Linux. It just happens to be the case most of the time, but a sysadmin can set a user's homedir to whatever they want. – Joe Holloway Aug 04 '14 at 15:04
1

Setting the HOME variable defeats this. – GLRoman Apr 22 '20 at 22:02

score 16 · Answer 8 · answered Dec 09 '20 at 20:10

16

psutil provides a portable way that doesn't use environment variables like the getpass solution. It is less prone to security issues, and should probably be the accepted answer as of today.

import psutil

def get_username():
    return psutil.Process().username()

Under the hood, this combines the getpwuid based method for unix and the GetTokenInformation method for Windows.

answered Dec 09 '20 at 20:10

Erik Aronesty

11,620
5
64
44

Is there a function in there to get it without the domain or do I split it on the `/` ? – CeePlusPlus Oct 22 '21 at 16:36
split on the "\\" if present, yes, see: https://github.com/giampaolo/psutil/issues/1049 – Erik Aronesty Sep 01 '22 at 15:45

score 15 · Answer 9 · answered Nov 08 '13 at 17:47

15

Combined pwd and getpass approach, based on other answers:

try:
  import pwd
except ImportError:
  import getpass
  pwd = None

def current_user():
  if pwd:
    return pwd.getpwuid(os.geteuid()).pw_name
  else:
    return getpass.getuser()

answered Nov 08 '13 at 17:47

anatoly techtonik

19,847
9
124
140

[getpass.getuser()](https://docs.python.org/3/library/getpass.html#getpass.getuser) Retrieves non-empty string from these environment variables LOGNAME, USER, LNAME and USERNAME, in order. If none are set, then login name from password database is returned on systems which support pwd module, else raises exception. [pw_name](https://docs.python.org/3/library/pwd.html) is also login name – Abhijeet Jun 10 '22 at 02:27
I might only use the `pwd` side, but this is the only answer here that gets the name of the _effective_ user ID. – neuralmer Jul 29 '22 at 20:04

score 7 · Answer 10 · edited Aug 26 '20 at 22:00

7

For UNIX, at least, this works...

import commands
username = commands.getoutput("echo $(whoami)")
print username

edit: I just looked it up and this works on Windows and UNIX:

import commands
username = commands.getoutput("whoami")

On UNIX it returns your username, but on Windows, it returns your user's group, slash, your username.

--

I.E.

UNIX returns: "username"

Windows returns: "domain/username"

--

It's interesting, but probably not ideal unless you are doing something in the terminal anyway... in which case you would probably be using os.system to begin with. For example, a while ago I needed to add my user to a group, so I did (this is in Linux, mind you)

import os
os.system("sudo usermod -aG \"group_name\" $(whoami)")
print "You have been added to \"group_name\"! Please log out for this to take effect"

I feel like that is easier to read and you don't have to import pwd or getpass.

I also feel like having "domain/user" could be helpful in certain applications in Windows.

edited Aug 26 '20 at 22:00

HoldOffHunger

18,769
10
104
133

answered Sep 16 '14 at 17:31

dylnmc

3,810
4
26
42

2

WIndows returns `domain/user` not `group/user` – RealHowTo Nov 04 '14 at 19:41
4

The commands module does not work on Windows. It's a UNIX specific module (see https://docs.python.org/2/library/commands.html). It's now deprecated and subprocess is recommended instead. `user = subprocess.check_output("whoami").replace("\r\n", "")` – ConnectedSystems Dec 03 '16 at 04:59
2 remarks. commands.whoami did great, even in the context of a service running under a different username. i.e. with `chpst -u nobody python ./manage.py celerycam --pidfile=/var/run/celerycam/celerycam.pid ` I got **nobody**. second, `user = subprocess.check_output("whoami").strip()` is more portable than the replace linefeeds above. `commands` vs `subprocess` seems nitpicky but commands is missing from python 3. – JL Peyret Dec 21 '17 at 01:11
-1 for using unsafe methods, at the very least you should be using `subprocess`, but spawning a separate process for this is excessive regardless. – alexia Nov 23 '21 at 14:30

score 7 · Answer 11 · edited Jun 12 '23 at 21:40

7

Using only standard python libs:

from os import environ
from sys import platform

def getUser():
    return environ["USERNAME"] if platform.startswith("win") else environ["USER"]

user = getUser()

Works on Windows, Mac or Linux.

edited Jun 12 '23 at 21:40

Rob Grant

7,239
4
41
61

answered May 13 '19 at 13:47

ThisGuyCantEven

1,095
12
21

2

getpass is also a standard lib – jodag Feb 12 '20 at 21:50
doesnt work for me in win10, python3.7.4. its complaining about 'USER' not being found in envirnment variables I guess. I guess getpass is a better choice anyway. – Hossein Jun 06 '20 at 07:15
The only thing that would cause this is if you run it from a drive other than `C:`. That is the only reason it would use the `USER` key and not `USERNAME`. This is literally just an if/else... All it does is use `USERNAME` if there is a `C:` drive else `USER` – ThisGuyCantEven Jul 09 '20 at 14:56
This is just a hacky solution and will break if your current working directory is on another drive. Your answer doesn't really provide a benefit over the others. There are better ways to check the platform even if you wanted to go that way, but usually it's preferable to use something that's portable from the start. – alexia Nov 23 '21 at 14:31
1

@Rob Grant good edit – ThisGuyCantEven Jun 13 '23 at 20:55

Dmitry T. · Answer 12 · 2021-04-28T11:54:45.487

None of the above worked in my case (scroll down to the actual solution).
The problem I'm getting with all solutions is the wrong username when running commands with sudo:

psutil soulution:

$ python3
>>> import psutil
>>> psutil.Process().username()
'ubuntu' # OK!

$ sudo su
$ python3
>>> import psutil
>>> psutil.Process().username()
'root' # OK!

$ sudo python3
>>> import psutil
>>> psutil.Process().username()
'root' # WRONG, should be ubuntu!

getpass solution:

$ python3
>>> import getpass
>>> getpass.getuser()
'ubuntu' # OK!

$ sudo su
$ python3
>>> import getpass
>>> getpass.getuser()
'root' # OK!

$ sudo python3
>>> import getpass
>>> getpass.getuser()
'root' # WRONG, should be ubuntu!

pwd + os.getuid solution:

$ python3
>>> import os, pwd
>>> pwd.getpwuid( os.getuid() )[ 0 ]
'ubuntu' # OK!

$ sudo su
$ python3
>>> import os, pwd
>>> pwd.getpwuid( os.getuid() )[ 0 ]
'root' # OK!

$ sudo python3
>>> import getpass
>>> getpass.getuser()
'root' # WRONG, should be ubuntu!

os.getlogin works a bit different, but still wrong:

$ python3
>>> import os
>>> os.getlogin()
'ubuntu' # OK!

$ sudo su
$ python3
>>> import os
>>> os.getlogin()
'ubuntu' # WRONG, should be root!


$ sudo python3
>>> import os
>>> os.getlogin()
'ubuntu' # OK!

os.getenv gives the same results:

$ python3
>>> import os
>>> os.getenv('SUDO_USER', os.getenv('USER'))
'ubuntu' # OK!

$ sudo su
$ python3
>>> import os
>>> os.getenv('SUDO_USER', os.getenv('USER'))
'ubuntu' # WRONG, should be root!


$ sudo python3
>>> import os
>>> os.getenv('SUDO_USER', os.getenv('USER'))
'ubuntu' # OK!

Switching SUDO_USER and USER gives the wrong result in sudo python3 case.

Actual solution (non-portable)

Solution is a bit tricky and rely on the default root home directory location but works for all cases:

$ python3
>>> import os
>>> 'root' if os.path.expanduser('~') == '/root' else os.getenv('SUDO_USER', os.getenv('USER'))
'ubuntu' # OK!

$ sudo su
$ python3
>>> import os
>>> 'root' if os.path.expanduser('~') == '/root' else os.getenv('SUDO_USER', os.getenv('USER'))
'root' #  OK!

$ sudo python3
>>> import os
>>> 'root' if os.path.expanduser('~') == '/root' else os.getenv('SUDO_USER', os.getenv('USER'))
'ubuntu' # OK!

But grateful for it - deals with the `sudo` issue for that very different question for those looking for the answer to it from a Google search that leads here. Perhaps only a *somewhat* different question. — Dan Nissenbaum, Aug 31 '21 at 15:11
sudo escalates so root is effectively the user. if you want to be able to define your own user, I recommend creating a -u/--user flag so you can do something like `sudo ./foo.py -u myUser`, etc — dylnmc, Nov 18 '21 at 21:42
As the others said, the result you are getting is not wrong. The command *is* running as root for all intents and purposes. This may be useful to someone but it's not an answer to OP's question. — alexia, Nov 23 '21 at 14:42

score 3 · Answer 13 · answered Nov 20 '13 at 08:12

You can get the current username on Windows by going through the Windows API, although it's a bit cumbersome to invoke via the ctypes FFI (GetCurrentProcess → OpenProcessToken → GetTokenInformation → LookupAccountSid).

I wrote a small module that can do this straight from Python, getuser.py. Usage:

import getuser
print(getuser.lookup_username())

It works on both Windows and *nix (the latter uses the pwd module as described in the other answers).

score 2 · Answer 14 · answered Feb 04 '10 at 19:52

2

I wrote the plx module some time ago to get the user name in a portable way on Unix and Windows (among other things): http://www.decalage.info/en/python/plx

Usage:

import plx

username = plx.get_username()

(it requires win32 extensions on Windows)

answered Feb 04 '10 at 19:52

decalage

61
1
1

score -4 · Answer 15 · answered Aug 26 '22 at 19:17

-4

this works for me:

import os
os.cmd("whoami")
print (os.cmd("whoami"))

answered Aug 26 '22 at 19:17

RobD

91
1
7

There is no `os.cmd`. Is this Python's built-in [`os` module](https://docs.python.org/3/library/os.html)? – Gino Mempin Aug 27 '22 at 10:42
yes the built-in os module. running Python 3.7 running on a Pi4B with RaspberryOS Buster. – RobD Aug 28 '22 at 10:50
Hmm, interesting, because it's not listed in the [Python 3.7 docs for the `os` module](https://docs.python.org/3.7/library/os.html). – Gino Mempin Aug 28 '22 at 10:56
hhmmm a non-documented feature. normally called a "bug" :-) – RobD Sep 05 '22 at 10:57

Is there a portable way to get the current username in Python?

15 Answers15

Actual solution (non-portable)

Linked

Related