# Quarkus run configuration

The Quarkus run/debug configuration defines how to run your Quarkus application in IntelliJ IDEA. It is automatically created if your project contains Quarkus dependencies. This run configuration runs your Quarkus application in development mode enabling live reload.

![Quarkus run configuration](https://resources.jetbrains.com.cn/help/img/idea/2026.2/workspace.xml`.     |
|   Application module   |  Select the root module of the application.  |

## More options

### Operating system

| Item | Description |
| --- | --- |
| Allow multiple instances | Allow multiple instances of this run configuration to execute at the same time. By default, this option is disabled, which means that when you run the configuration, other active sessions of the configuration will terminate. |
| Environment variables |  Click ![the Browse button](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app.general.inlineVariables.svg) to open the Environment Variables dialog where you can create variables and specify their values. |
|   Emulate Terminal   |  Emulate the native Quarkus CLI in the Run tool window. This parameter is currently available in Maven projects only.  |

### Java

| Item | Description |
| --- | --- |
| Do not build before run | Run the application straight away without launching the build process. |
| VM options |     Specify the options to be passed to the Java virtual machine when launching the application, for example, `-mx`, `-verbose`, and so on.      When specifying JVM options, follow these rules:       * Use spaces to separate individual options.    * If the value of an option includes spaces, enclose either the value or the actual spaces with double quotes.    * If an option includes double quotes as part of the value, escape the double quotes using backslashes.    * You can pass environment variable values to custom Java properties.      ```PLAINTEXT -Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR} ```                          Use code completion in this field: start typing the name of a flag, and the IDE suggests a list of available command line options. This works for `-XX:` and `-X` options and some standard options that are not configured by IntelliJ IDEA automatically, like `-ea`, but not for `-cp` or `–release`.                          The `-classpath` option specified in this field overrides the classpath of the module.    |

### Logs

Specify which log files generated while running or debugging the application should be displayed in the console on the dedicated tabs of the [Run](run-tool-window.html) or [Debug tool window](debug-tool-window.html).

### Quarkus

| Item | Description |
| --- | --- |
|  Run profile  |  Specify [profiles](https://quarkus.io/guides/config-reference#profiles) to be used in the application.  |
|   Add arguments   |  Pass arguments to your application. Use the same syntax as for specifying the [VM options](#java).  |

### Before launch

Select tasks to be performed before starting the selected run/debug configuration. By default, the Build task will be performed.

## Quarkus Application run configuration

IntelliJ IDEA also comes with the Quarkus Application run configuration. It is automatically created when you run your application from the Run gutter icon ![](https://resources.jetbrains.com.cn/help/img/idea/2026.2/app-client.expui.run.run.svg) in a class annotated with `@QuarkusMain`.

Unlike the Quarkus run configuration, which uses build tool tasks to start the application, the Quarkus Application uses the `java` command.

This run configuration is almost identical to the [Application](run-debug-configuration-java-application.html) run configuration; refer to it for description of the run configuration parameters.