Custom default values for system settings

System-wide default settings can be set by providing a default for a key in a dconf profile. These defaults can be overridden by the user.

Set a default value

To set a default for a key, the user profile must exist and the value for the key must be added to a dconf database.

An example demonstrating how to set the default background

  1. Create the user profile:

    /etc/dconf/profile/user

    user-db:user
    system-db:local

    local is the name of a dconf database.

  2. Create a keyfile for the local database which contains the default settings:

    /etc/dconf/db/local.d/01-background

    # dconf path
    [org/gnome/desktop/background]
    
    # dconf key names and their corresponding values
    picture-uri='file:///usr/local/share/backgrounds/wallpaper.jpg'
    picture-options='scaled'
    primary-color='000000'
    secondary-color='FFFFFF'
  3. Update the system databases:

    # dconf update

When the user profile is created or changed, the user will need to log out and log in again before the changes will be applied.