qbs setup-toolchains [--settings-dir <directory>] [--system] --detect
qbs setup-toolchains [--settings-dir <directory>] [--system] [--type <toolchain type>]
                     <compiler path> <profile name>


The first form tries to auto-detect all known toolchains, looking them up via the PATH variable.

The second form creates a profile with the name <profile name> for the toolchain located at <compiler path>. It will attempt to determine the toolchain type automatically based on the file name or the compiler executable. If that fails, you need to provide the compiler type as a value of the --type option.

For more information, see Configuring Profiles and Preferences.


--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


If this option is given, the profile(s) created by this tool will end up in the system-level settings and thus be available to all users. Otherwise, they go into the user-level settings.


Attempts to auto-detect all known toolchains, looking them up in the PATH environment variable.

--type <toolchain type>

Specifies the type of the toolchain. Needed if Qbs cannot determine the compiler from the name of the executable file located in the specified directory.

Possible values include:

  • clang
  • gcc
  • mingw
  • msvc
  • iar
  • keil
  • sdcc
  • cosmic
  • dmc
  • watcom


Displays help for the command.


Looks up toolchains via the PATH variable and creates profiles for them:

qbs setup-toolchains --detect

Creates a profile called mingw for the toolchain located in C:\mingw530_32\bin on Windows:

qbs setup-toolchains C:\mingw530_32\bin\g++.exe mingw

Creates a profile called g++-mingw-w64 for the toolchain located in /usr/bin/x86_64-w64-mingw32-g++ g++-mingw-w64 on Ubuntu:

qbs setup-toolchains /usr/bin/x86_64-w64-mingw32-g++ g++-mingw-w64

© 2022 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.