# Application Servers

> **TL;DR**
> Windows and Linux: `File | Settings | Build, Execution, Deployment | Application Servers`
>
>
>
> macOS: `IntelliJ IDEA | Settings | Build, Execution, Deployment | Application Servers`
>
>
>
> From the Run/Debug Configurations dialog: Configure when editing a run/debug configuration for an application server.

Use this page or dialog to manage configurations for the supported application servers and their settings.

The servers that are already defined in IntelliJ IDEA are shown in the pane under ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.add.svg) and ![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg). When you select a server in this pane, the corresponding configuration settings and associated controls are shown in the area to the right. (If you are editing a run configuration for a particular server (for example, Tomcat), only the existing configurations for this particular server are shown.)

Use ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.add.svg) to create server configurations and ![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg) to remove them.

By the time you start creating a server configuration, the corresponding server must already be installed on your computer.

Note that the list of servers you can work with depends on which server integration [plugins](managing-plugins.html) are currently enabled.

## Toolbar

| Item | Description |
| --- | --- |
| ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.add.svg) `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (NetBeans), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) |    Use this icon or shortcut to create a server configuration (that is, to define a server in IntelliJ IDEA):       1.  If the server list is shown, select the server of interest.    2.    In the dialog that opens, specify the server settings and click OK.      For most of the servers, you just need to specify the server installation directory (referred to as the server home). For more information, refer to [Main settings and controls](#main_settings).       |
| ![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg) `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Alt+Delete` (NetBeans), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS)) | Use this icon or shortcut to remove the selected application server configuration. |

## Main settings and controls

| Item | Description |
| --- | --- |
| Name | The server configuration name. |
| <Server> Home | The path to the application server installation folder.     Click ![the Browse button](https://resources.jetbrains.com/help/img/idea/2026.2/app-client.expui.inline.browse.svg) and select the necessary folder.    |
| <Server> Version | The detected application server version (readonly). |
| <Server> base directory (for Tomcat, TomEE, and Jetty) | The path to the server base directory.      Set it to configure the [CATALINA_BASE](https://tomcat.apache.org/tomcat-8.5-doc/introduction.html#CATALINA_HOME_and_CATALINA_BASE) property if you use Tomcat or the [JETTY_BASE](https://jetty.org/docs/jetty/12/operations-guide/begin/index.html#quick-setup) property if you use Jetty. This can be useful if you want to run multiple instances of the same server on the same machine.      Click ![the Browse button](https://resources.jetbrains.com/help/img/idea/2026.2/app-client.expui.inline.browse.svg) and select the directory in the [dialog that opens](null).    |
| Register schemas (for JBoss) |     To be able to validate JBoss XML configuration files (such as `standalone.xml`, `domain.xml`, and so on) when editing them in IntelliJ IDEA, you can register XML schemas (XSDs) available in the JBoss installation:       1.  Click Register schemas.    2.     To register all the schemas, just click OK in the dialog that opens.      If there are schemas that you don't want to register, select those schemas under External Schemas and DTDs, click ![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg) and then click OK.        To view or edit the schema list at a later time, use the [Schemas and DTDs page](settings-languages-schemas-and-dtds.html) in the [Settings dialog](settings-preferences-dialog.html).     |

See also, [Libraries](#libs) and [Additional Libraries for Frameworks](#additional_libs).

## Libraries

When you create a server configuration, normally, an associated application server [library](library.html) is created. As a rule, this library includes Servlet, JSP and EJB implementations available in the server distribution.

Use the controls under Libraries to manage the contents of the library.

| Item | Description |
| --- | --- |
| ![the Add button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.add.svg) `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Alt+Insert` (NetBeans), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) |    Add items (classes, sources, documentation, and so on) to the library.      In the dialog that opens, select the necessary files and folders. These may be individual `class` and `java` files as well as directories and archives `jar` and `zip` containing such files.      IntelliJ IDEA will analyze the selected files and folders, and automatically assign their contents to the appropriate library categories (Classes, Sources, Documentation, and so on).      When IntelliJ IDEA cannot guess the category (for example, when you select an empty folder), a dialog will be shown, in which you will be able to specify the category yourself.    |
| ![the Specify Documentation URL button](https://resources.jetbrains.com/help/img/idea/2026.2/app.toolbarDecorator.addLink.svg) |  To be able to use external documentation available online, click this icon and specify the URL of the external documentation.  |
| ![the Execute button](https://resources.jetbrains.com/help/img/idea/2026.2/app.modules.addExcludedRoot.svg) | Exclude an item (refer to [Exclude library items](library.html#excluded_lib_items)).  In the dialog that opens, select the items that you want IntelliJ IDEA to ignore (folders, archives and folders within the archives), and click OK.  In the dialog that opens, select the folders that you want IntelliJ IDEA to ignore, and click OK.  |
| ![the Remove button](https://resources.jetbrains.com/help/img/idea/2026.2/app.expui.general.remove.svg) `Delete` (Windows), `⌦` (macOS), `⌦` (IntelliJ IDEA Classic (macOS)), `⌦` (macOS System Shortcuts), `Delete` (XWin), `Delete` (GNOME), `Delete` (KDE), `Delete` (Emacs), `Delete` (Sublime Text), `⌦` (Sublime Text (macOS)), `Delete` (NetBeans), `Delete` (Visual Studio), `⌦` (Visual Studio (macOS)), `Delete` (Eclipse), `⌦` (Eclipse (macOS)) |    This option allows you to:       * Remove the selected ordinary library from the library.    * Restore the selected excluded items. The items themselves will stay in the library.    |

## Additional Libraries for Frameworks

For certain application server configurations, there is an Additional Libraries for Frameworks list with checkboxes.

Each item in this list, potentially, is a [library](library.html) that implements the corresponding framework. (Corresponding library files are included in the server distribution.)

When you select a checkbox in the list, the corresponding application server library is created. The dialog that opens lets you select the modules in which this library should be used. (As a result, the library is added to dependencies of the selected modules.)

## See also

### Procedures

[Application servers](application-servers-support.html)  [Jakarta EE](java-ee.html)  [Web applications](developing-web-applications.html)

### Tutorials and Examples

[Tutorial: Your first Jakarta EE application](creating-and-running-your-first-jakarta-ee-application.html)

### Reference

[Run/debug configurations dialog](run-debug-configurations-dialog.html)

