9.5. Configuring Custom Default Values
Machine-wide default settings can be set by providing a default for a key in a
dconfprofile. These defaults can be overridden by the user.
To set a default for a key, the
userprofile must exist and the value for the key must be added to a
Example 9.1. Set the Default Background
- If it does not already exist, create the
user-db:user system-db:localwhere local is the name of a
- Create a keyfile for the local database in
/etc/dconf/db/local.d/01-background, which contains the following default settings:
# dconf path [org/gnome/desktop/background] # GSettings key names and their corresponding values picture-uri='file:///usr/local/share/backgrounds/wallpaper.jpg' picture-options='scaled' primary-color='000000' secondary-color='FFFFFF'In the default setting of the keyfile, the following GSettings keys are used:
Table 9.1. org.gnome.desktop.background schemas GSettings Keys
Key Name Possible Values Description picture-options "none", "wallpaper", "centered", "scaled", "stretched", "zoom", "spanned" Determines how the image set by wallpaper_filename is rendered. picture-uri filename with the path URI to use for the background image. Note that the backend only supports local (file://) URIs. primary-color default: 000000 Left or Top color when drawing gradients, or the solid color. secondary-color default: FFFFFF Right or Bottom color when drawing gradients, not used for solid color.
- Edit the keyfile according to your preferences. For more information, see Section 9.3, “Browsing GSettings Values for Desktop Applications”.
- Update the system databases:
userprofile is created or changed, the user will need to log out and log in again before the changes will be applied.
If you want to avoid creating a
userprofile, you can use the
dconfcommand-line utility to read and write individual values or entire directories from and to a
dconfdatabase. For more information, see the
dconf(1) man page.
9.5.1. Locking Down Specific Settings
The lockdown mode in
dconfis a useful tool for preventing users from changing specific settings.
To lock down a
GSettingskey, you will need to create a
lockssubdirectory in the keyfile directory (for instance,
/etc/dconf/db/local.d/locks/). The files inside this directory contain a list of keys to lock, and you may add any number of files to this directory.
If you do not enforce the system settings using a lockdown, users can easily override the system settings with their own. Any settings users have made will take precedence over the system settings unless there is a lockdown enforcing the system settings.
The example below demonstrates how to lock settings for the default wallpaper. Follow the procedure for any other setting you need to lock.
Example 9.2. Locking Down the Default Wallpaper
- Set a default wallpaper by following steps in Section 10.5.1, “Customizing the Default Desktop Background”.
- Create a new directory named
- Create a new file in
/etc/dconf/db/local.d/locks/00-default-wallpaperwith the following contents, listing one key per line:
# Prevent users from changing values for the following keys: /org/gnome/desktop/background/picture-uri /org/gnome/desktop/background/picture-options /org/gnome/desktop/background/primary-color /org/gnome/desktop/background/secondary-color
- Update the system databases: