GNOME/GDM

GDM is the GNOME Display Manager, which provides a graphical login environment.

= Introduction =

Many users want to boot straight into a graphical environment, rather than having to log on through a Linux console and then using the  command to launch the graphical desktop environment (such as GNOME). Graphical display managers provide this service, and GNOME has one called the GNOME Display Manager, or GDM.

There are two main GDM versions available in the portage tree: release 2 and release 3. Those are coupled to the GNOME release and even though GNOME 3 is stable, some users still want to stick to the v2 release.

= GNOME Display Manager v2 =

In order to use GDM v2, it is necessary to mask GDM v3 (which might already be the case if a GNOME 2 deployment was done):

Then, if GDM has not been installed yet, it can simply be emerged.

Configuring GDM
To configure GDM, all that is needed is to tell the system that it should start at boot up.

Below, the common approaches using OpenRC (Gentoo's default init system) and systemd (an alternative init system) are described.

OpenRC
First, configure the XDM (X11 Display Manager) init script to launch GDM. Gentoo uses the XDM init script as a wrapper for the display manager that the user wants.

Add the init script to the default runlevel so that it starts up on boot:

All that is left is to start the service manually now (or reboot the system to have it done automatically):

systemd
The GDM package provides the necessary unit file. However, you still need to copy it in place manually:

To start gdm upon boot, enable the gdm service:

To start gdm immediately, launch it through :

= GNOME Display Manager v3 =

Configuring GDM v3 is only possible through systemd as it does not support other init systems anymore (which is a general feature of GNOME 3).

To start gdm upon boot:

To start gdm immediately:

= More info =

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:
 * 666threesixes666