Qbs Manual | Command-Line Interface | config

Qbs 1.11.0

# config

## Synopsis

      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>

## Description

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.

## Options

### `--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>`.

### `--help|-h|-?`

Displays help for the command.

## Parameters

### `<key>`

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.

## Examples

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