Scroll to navigation

UKUI-SESSION(1) General Commands Manual UKUI-SESSION(1)


ukui-session - Start the UKUI Desktop Environment.


ukui-session [OPTIONS]


The ukui-session program starts up the UKUI desktop environment. This command is typically executed by your Login/Display Manager (like GDM, LXDM, XDM, SLiM, or from your X startup scripts like .xinitrc). It will load either your saved session, or it will provide a default session for the user as defined by the system administrator (or the default UKUI installation on your system).

The default session is defined in the dconf keys under /org/ukui/desktop/session/
When saving a session, ukui-session saves the currently running applications in the ~/.config/ukui-session/saved-session directory of the users /home.

ukui-session is an X11 session manager. It can manage UKUI applications as well as any other X11 SM compliant ones.


The following options are supported:

-a, --autostart=DIR
Start all applications defined in "DIR", instead of starting the applications defined in /org/ukui/desktop/session/default-session
Multiple --autostart options can be passed.
-f, --failsafe
Run in fail-safe mode. User-specified applications will not be started.
Enable debugging code.
X display to use.
Output version information and exit.
-?, -h, --help
Print standard command line options.
Print all command line options.


ukui-session sets several environment variables for the use of its child processes:

This variable is used by session-manager aware clients to contact ukui-session.


This variable is set to the X display being used by ukui-session. Note that if the --display option is used this might be different from the setting of the environment variable when ukui-session is invoked.


The applications defined in the above directories will be started on login. ukui-session-properties(1) can be used to easily configure them.


This directory contains the list of applications of the saved session.


Should you encounter any bugs, they may be reported at:


This Manual page was originally written for gnome-session by:

Miguel de Icaza <> (2000)
Vincent Untz <> (2009-2010)

It has been updated for the MATE Desktop Environment by:

Adam Erdman <> (2014)

It has been updated for the UKUI Desktop Environment by:

yilei <> (2016)


Further information may also be available at:

ukui-session-properties(1), ukui-session-save(1), ukui-wm(1)
11 February 2016 UKUI Desktop Environment