What is the purpose of the .xsession file in the home folder? What should be put in there? The desktop environments don't use that file and for the X startup from the tty there is .xinitrc.


If you log in in text mode then start a GUI session with xinit or with the wrapper script startx, then xinit does the following things:

  • Start an X server (typically through the script /etc/X11/xinit/xserverrc).
  • Usually run some scripts in /etc/X11 (typically /etc/X11/xinit/xinitrc), depending on how it's set up.
  • Run ~/.xinitrc, if it exists. If it doesn't exist, run a default client (traditionally xterm).
  • Once ~/.xinitrc terminates, kill the X server.

If you log in in graphical mode on an X display manager (xdm, gdm, kdm, wdm, lightdm, …), traditionally, what is executed after you log in is some scripts in /etc/X11 then ~/.xsession.

~/.xsession has the role of ~/.profile and ~/.xinitrc combined: it's supposed to perform the initial startup of your session (e.g. define environment variables), then launch programs specific to the GUI (usually at least window manager).

Nowadays, most X display managers give you a choice of a session. Choosing a particular session launched a specific desktop environment, session manager, window manager. What is executed then is only that DE/SM/WM and whatever programs it chooses to start based on whatever configuration files it chooses to read. Many environments provide a “custom session” that reads the traditional ~/.xsession.

| improve this answer | |
  • 3
    I don't know what is this "many environments", but at least kdm silently ignores the «~/.xsession» file. – Hi-Angel Feb 18 '15 at 19:18
  • 1
    @Hi-Angel The .xsession file is only read if you select a particular session type. I know that for Gdm, the upstream developers don't want to include one that runs .xsession by default, and leave it up to each distribution, and many distributions don't bother or don't realize the need. I don't know what the kdm situation is. – Gilles 'SO- stop being evil' Feb 18 '15 at 20:12
  • Well, you know, I found in man kdm that kdm have an own file /etc/kde4/kdm/Xsession to be ran as user just after login. They're lie — the file (which is present btw) never being touched by kdm, I even did removed it at all, and that didn't changed anything. – Hi-Angel Feb 19 '15 at 4:58
  • 1
    @Hi-Angel What Gilles means is that at your graphical login screen you'll often have a dropdown menu listing various environments. If you choose "KDE," that will start and it will ignore .xsession, as you described. But if, instead of "KDE," you choose "Custom session," .xsession will be run instead of KDE. I use this, for example, because I run just xfce4-panel and FVWM 2 as my "desktop"; if KDE were installed on a system I happened to be using, it would be completely ignored. – cjs Jul 26 '17 at 2:10

X session startup can be complicated these days. A good place to start is the script /etc/X11/Xsession to see how things will get executed.

On my Debian/Ubuntu systems, the script /etc/X11/Xsession sets the variable USERXSESSION=$HOME/.xsession. Later, the script /etc/X11/Xsession.d/50x11-common_determine-startup looks for this script and uses it as the primary session, if allowed by system policy in /etc/X11/Xsession.options, and if no other session was requested by the display manager.

| improve this answer | |

I strongly recommend you to take a look in the book X Window system administrator's guide : for X version 11. Chapter 2 explains the purpose of .xsession and the whole configuration process for a sample setup. Also it's a nice refresher for the whole x-window related terminology (and i hope you don't get spooked :) ). You can get the book from


Although it's rather outdated you can find a lot of information of the underlying concepts that didn't change until today and it is very legible. Moreover it is really funny to take a look at what was top notch at those days.

| improve this answer | |

.xsession is the traditional startscript for the X11 environment. Nowadays with sessionmanagers like kdm it is not that much of a use anymore, but on a traditionaly set up system. This is what is run after starting X11 with startx.

| improve this answer | |

Not the answer you're looking for? Browse other questions tagged or ask your own question.