qbs config [--settings-dir <directory>] [--list [<root> ...]]
           [--unset <key>] [--export <file>] [--import <file>]
qbs config [--settings-dir <directory>] <key>
qbs config [--settings-dir <directory>] <key> <value>


Manages Qbs settings, such as preferences and profiles. You can list all keys and remove the specified key, as well as import settings from a file or export them to a file.

The second form of this command displays the specified <key>.

The third form sets the specified <key> with the specified <value>.

You can use the config-ui command to open the Qbs Settings tool for managing settings in a hierarchical view.

For more information, see Configuring, Managing Qt Versions, Modules, List of Modules, and Custom Modules and Items.


--settings-dir <directory>

Reads all settings (such as profile information) from the specified <directory>. If the directory does not exist, it will be created.

The default value is system-specific. For example:

  • Linux: $HOME/.config/QtProject/qbs
  • Windows: %APPDATA%\QtProject\qbs
  • macOS: $HOME/Library/Preferences/qbs

--list [<root> ...]

Lists keys under the key <root> or all keys if the root is not specified.

Possible values are:

  • defaultProfile is the default profile to use if a profile is not specified
  • preferences accepts build preferences as second-level keys
  • profiles accepts profile names as second-level keys

--unset <key>

Removes the specified <key>.

--export <file>

Exports settings to the specified <file>.

--import <file>

Imports settings from the specified <file>.


Displays help for the command.



Typically, a <key> consists of several levels separated by periods. The first level shows a root value, such as preferences or profiles. The root determines whether the second-level keys are build preferences or profile names. The lower level keys consist of a module name, followed by a property name.


Lists the existing profiles:

qbs config --list profiles

Shows the default profile:

qbs config defaultProfile

Note: If no output is shown, the default profile used is the built-in profile none, which sets no properties.

Sets the profile called gcc as the base profile of the Qt profile called myqt:

qbs config profiles.myqt.baseProfile gcc

Adds the location of a custom module to your preferences, to make the module accessible in several projects:

qbs config preferences.qbsSearchPaths /usr/local/share/custom-qbs-extensions

© 2018 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.