Skip to content

Modern X Client Definition Requirements

Launching a desktop or X client from a modern Linux operating system requires a unique D-Bus session that supports the client session. D-Bus is an inter-process communication (IPC), and a remote procedure call (RPC) mechanism that allows communication between X clients in the same user session.

For a GNOME 3 Desktop session launched from the GDM Login Screen (XDMCP), these conditions are handled by GDM and do not need to be configured in Reflection X.

If you're not using an XDMCP connection, you'll need to launch a D-Bus session on your client command line as follows.


Using the dbus-run-session command is the best method to start the D-Bus for an X client.

To configure a command to launch a modern X client such as GNOME Terminal

  1. On the X Manager window, click the Plus button next to X Clients to create a new client definition.

  2. In the new client definition, enter a Name and the Host name.

  3. From the Host type drop-down list, select Linux.

  4. From the Command drop-down list, select Terminal.

  5. In the Session list, select a session definition that has the appropriate extensions enabled for a modern X client.

    The client command should contain the following elements:

    (dbus-run-session -- /usr/bin/gnome-terminal --display=%IP#% --wait)

    You can use one of the sample GNOME 3 X client definitions such as Linux - gnome-terminal (GNOME 3). If these samples are not listed in the X Manager window under Session Definitions, you can add them by importing the linux_gnome3_templates.rxd template file. (See Import Installed Templates.)

When you start the session, the dbus-run-session command launches the client with a unique D-Bus session and terminates the D-Bus session when the gnome-session client exits.


The dbus-run-session command is available only on newer systems such as RHEL 6.10 and above and RHEL 7.6 and above. To set up a unique D-Bus session on older systems, use the dbus-launch command instead.

More information

Back to top