Configure projects for running | Qt Creator Documentation

- Qt Creator Documentation
- Configure projects for running
- Qt Creator 19.0.0

Configure projects for building ◦ Edit environment settings

# Configure projects for running

To specify settings for running applications on the Run device that you select for a kit, go to Projects > Run Settings.

The available run settings depend on the type of the project and the device:

- Android
- Boot to Qt
- Desktop
- Python
- QNX
- Remote Linux

## Manage run configurations

The available run configurations are listed in the Run configuration field. Each run configuration belongs to a particular build configuration, so switching the active build configuration also switches the set of available run configurations. You can specify run settings, such as command line arguments or environments, separately for each build configuration, such as Debug or Release.

To add run configurations for a build configuration, select Add.

To add a run configuration that is based on the active one, select Clone.

To copy the values from another run configuration into the active one, even if it belongs to another build configuration, select Clone into This.

To edit the active run configuration, select Ctrl+E, Ctrl+R (or Cmd+E, Cmd+R on macOS).

To rename the active run configuration, select Rename.

### Remove run configurations

To remove the active run configuration, select Remove. To remove all run configurations that belong to a build configuration, select Remove All.

To remove multiple run configurations:

1. Select Bulk Remove.
2. Multiselect run configurations by holding Ctrl and clicking them.
3. Select Remove selected.

### qmake run configurations

The run configurations for qmake projects derive their executable from the parsed `.pro` files. For more information on how the commands are constructed, see Start external processes.

## Select the default run target

If a project has multiple executables, you need to tell Qt Creator which one it should run.

### CMake run targets

When using CMake, you can filter the run target list by setting `qtc_runnable` as the value of the `FOLDER` property in the `CMakeLists.txt` file for the project. For example:

     set_target_properties(main_executable PROPERTIES FOLDER "qtc_runnable")

If you do not specify `qtc_runnable` for any project, Qt Creator automatically adds run configurations for all targets specified in `CMakeLists.txt`.

### qmake run targets

When using qmake, you can prevent Qt Creator from automatically creating run configurations for subprojects by specifying the `qtc_runnable` variable in the `.pro` files of the application projects (`TEMPLATE=app`) that you want to run. For example

     CONFIG += qtc_runnable

If none of your application projects specifies `qtc_runnable`, Qt Creator creates run configurations for all application projects.

If any of your application projects specifies `qtc_runnable`, Qt Creator creates run configurations only for subprojects that also have `CONFIG += qtc_runnable` set in their `.pro` files.

For more information about qmake project templates, see TEMPLATE.

### Meson run targets

Qt Creator automatically adds run configurations for all targets declared with `executable()` function in Meson build descriptions.

See also Enable debugging, Building and running projects, Set the default build and run directories, Specify a custom executable to run, and Specify Valgrind settings for a project.

Configure projects for building ◦ Edit environment settings