dconf is a low-level configuration system and settings management tool. Its main purpose is to provide a back end to [|GSettings] on platforms that don't already have configuration storage systems. It depends on GLib. It is part of GNOME 3 and is a replacement for GConf.


dconf is a simple key-based configuration system. Keys exist in an unstructured database.
Change notification is supported.
Stacking of multiple configuration sources is supported. Mandatory keys are supported.
The stacking can be done at "mount points". For example, the global system configuration can be mounted under /system/ inside of each user's configuration space. A single configuration source may appear at multiple points in the hierarchy. For example, in addition to stacking over the normal keys at /user/, the system default keys may also appear at /default/ for inspection and modification by a system policy configuration utility.
PolicyKit integration is planned so that a normal user may temporarily gain the ability to, for example, write to the keys under /system/. This means that programs like the GNOME Display Manager configuration utility no longer have to be run as root.

Software architecture

Since a typical GNOME login consists of thousands of reads and ideally 0 writes, dconf is optimized for reads. Typically, reading a key from dconf involves zero system calls and zero context switches. This is achieved with a simple file format that doubles both as the storage format for data in dconf and as an IPC mechanism between the clients and the server.
Avoiding round trips and context switches is desirable in itself, but the real advantage comes from allowing the I/O scheduler in the kernel to do a better job by saturating it with requests coming from all of the applications trying to read their keys.
Having all of the keys in a single compact binary format also avoids the intense fragmentation problems currently experienced by the tree-of-directories-of-xml-files approach.
Writes are less optimized they traverse the bus and are handled by a "writer" a D-Bus service in the ordinary way. Change notification is also handled by the writer. The reason for having a bus service at all is that because getting the clients to synchronize on writing would be very difficult.
The writer service doesn't have to be activated until the first write operation is performed.
The service is completely stateless and can start and stop dynamically. The list of change notifications that an individual client is interested in is maintained by the bus daemon.

dconf database

One dconf database consists of a single file in binary format, i.e. it is not a text-file. The format is defined as gvdb. It is a simple database file format that stores a mapping from strings to GVariant values in a way that is extremely efficient for lookups.
The GNOME database file for each user is by default ~/.config/dconf/user, a file expected to be in GVDB format.


GVariant is a strongly typed value datatype. GVariant is a variant datatype; it can contain one or more values along with information about the type of the values.
A GVariant may contain simple types, like integers, or boolean values; or complex types, like an array of two strings, or a dictionary of key value pairs. A GVariant is also immutable: once it's been created, neither its type nor its content can be modified further. GVariant is useful whenever data needs to be serialized, for example when sending method parameters in DBus, or when saving settings using GSettings.
GVariant is part of GLib.
The GSettings class provides a high-level API for application for storing and retrieving their own settings.
The utility program /usr/bin/gsettings is contained in .
GSettings is part of GIO. which is part of GLib.
A system administrators for dconf is available. Since version 0.2, dconf is licensed under the LGPL version 2.1 "or later".


Release history


stores preferences in customizable configuration files, usually in text form such as INI, XML, or JSON. In contrast to dconf, the system administrator chooses which configuration settings should be placed in which file by mounting.
Inkscape stores preferences in one XML file located at ~/.config/Inkscape/preferences.xml and %APPDATA%\inkscape\preferences.xml.
GIMP stores them in one file at /etc/gimp/2.0/gimprc and another one at $HOME/.gimp-2.8/gimprc overwriting the global settings if so.
KDE doesn't use dconf. In KDE, settings are stored in simple text files located at ~/.kde/share/config/<appname>rc or .kde/config/<appname>rc, rather than a database. The GUI for changing these settings is systemsettings, although individual application settings are usually set within the application.
Most Windows applications still store their user settings in individual.ini files spread across the disk. They additionally use the Windows Registry to store information which might be of interest for other software. For such programs the Windows Registry acts rather as a bulletin board, than as a user settings system. When such an application is removed, it is also rather the default than the exception, that its registry entries are not being purged and remain in the database. The Windows Registry is rather extensive and with time becomes more and more bloated. Without the user knowing exactly what to look for, a simple search can be compared to finding the "needle in a haystack." Therefore, with regards to purpose and volume, dconf cannot be compared to the Windows Registry. In fact the only commonality between dconf and the Windows Registry is the usage of a database.
The Windows Registry is structured into hives. Each hive is kept in a separate file. When a Windows system boots, the bootstrap loader loads the SYSTEM file into memory. A great deal of crucial information is kept in the SYSTEM hive, including information about what drivers to use with what devices, what software to run initially, and many parameters governing the operation of the system. The conventions for the arrangement of configuration information are poorly defined.