From Gentoo Wiki
GNOME(Redirected from GNOME/Configuration)
Jump to: navigation, search
This page contains changes which are not marked for translation.

Other languages:
English • ‎español • ‎français • ‎日本語 • ‎한국어 • ‎русский • ‎中文(中国大陆)‎
The information in this article is probably outdated. You can help the Gentoo Wiki by verifying and updating this article.
This article is a stub. You can help Gentoo Wiki by expanding it.

A frequently used environment is GNOME. This guide tries to describe all aspects of GNOME, including installation, configuration, usage, and more!

What is GNOME?

The project

The GNOME project is a free software project dedicated to the development of GNOME, a Unix/Linux desktop suite and development platform. The GNOME Foundation coordinates the development and other aspects of the GNOME Project.

The software

GNOME is a desktop environment and a development platform. This piece of free software is the desktop of choice for several industry leaders. It is interesting both for business users, home users, and developers.

The community

Like with any big free software project, GNOME has an extensive user and development base. GnomePlanet is a popular blog aggregator for GNOME hackers and contributors whereas Developer.Gnome.Org is for the GNOME developers. GNOME Library contains a huge list of GNOME resources for end users. The World of GNOME is also a popular aggregator for GNOME-related news.

Installing GNOME

What is needed?

First read and follow the instructions in the Xorg guide to setup a X environment.

Before installing GNOME, editing the system's USE variables is a good idea. Make sure that X, gtk, and gnome are in the USE variable located in /etc/portage/make.conf. If support for dbus add it to the USE flags (dbus is a system message bus Gnome uses extensively). If no KDE support is required, remove qt4 and kde from USE. USE flags can be removed by adding a minus sign (-) in front of them. See the example below for the minus sign used properly.

FILE /etc/portage/make.confExample USE flags for a GNOME desktop environment
USE="-qt4 -kde X dbus gtk gnome"

Adding the branding USE flag provides a lovely Gentoo-branded splash screen instead of the default GNOME splash screen:

root #echo "gnome-base/gnome-session branding" >> /etc/portage/package.use
When using the desktop/gnome profile, these USE flags will be set for you. It is possible to check the system profile by running eselect profile list. Modifications can be made by running eselect profile set <profile-name> as root. Be sure to replace "<profile-name>" with the number or name of the desired profile.

Once done, begin the GNOME installation by emerging GNOME:

root #emerge gnome-base/gnome

For a minimal GNOME installation, emerge gnome-light. This option provides a lightweight GNOME installation without the additional tools that a full GNOME installation provides so you might need to install additional packages afterwards.

root #emerge gnome-base/gnome-light
The gnome-base/gnome-light package does not pull in gnome-extra/gnome-screensaver, which is needed for locking the screen. Be aware the screen probably will not lock without it.

This will take a while, so you might want to start reading all those books your mother bought you but you never opened. Done? Great, now update environment variables:

root #env-update && source /etc/profile

Next the remaining services and user groups will be cleaned.

root #/etc/init.d/dbus start
root #rc-update add dbus default

Verify the plugdev group exists. If it does, it is advisable to make each GNOME user member of that group, but step this is optional (the group is not common anymore).

root #getent group plugdev

Substitute <username> in the next command with each GNOME user's user name:

root #gpasswd -a <username> plugdev

First impressions

It is time to take a look at what was just built. Exit the root shell and log in as a regular user. The next step is to configure the session manager to run GNOME when the the startx command is invoked (see using startx in the Xorg guide for more information).

user $echo "exec gnome-session" > ~/.xinitrc

Starting with gnome-base/gnome-session-2.26.2, users will need to prepend the XDG_MENU_PREFIX variable to get the GNOME menus when using the ~/.xinitrc method to start the desktop. If ~/.xinitrc is not being used it will be handled automatically; no additional configuration is needed.

user $sed -i '1i\export XDG_MENU_PREFIX=gnome-' ~/.xinitrc

Now start the graphical environment by issuing startx:

user $startx

If all goes well GNOME should happily provide a greeting. Congratulations on setting up GNOME!

It is possible to configure GNOME further. Take a look at the articles listed in GNOME/Guide#See_also for additional customization information.

See also

  • The GDM article describes how to setup the Gnome Display Manager to automatically boot into a graphical environment (rather than starting a GNOME session through startx).

External resources

This article is based on a document formerly found on our main website
The following people have contributed to the original document: Sven Vermeulen, Lars Strojny, nightmorph
They are listed here as the Wiki history does not provide for any attribution. If you edit the Wiki article, please do not add yourself here; your contributions are recorded on the history page.