Complete Guide to Configuring Tomcat Server in IntelliJ IDEA

Nov 23, 2025 · Programming · 9 views · 7.8

Keywords: IntelliJ IDEA | Tomcat | Web Application Development

Abstract: This article provides a comprehensive guide on configuring Tomcat server in IntelliJ IDEA, covering version requirements, server setup, deployment configurations, and common issue resolutions. Step-by-step instructions assist developers in transitioning from NetBeans to IntelliJ IDEA for efficient web application development and debugging.

IntelliJ IDEA Version Requirements and Preparation

Before configuring the Tomcat server, ensure you are using IntelliJ IDEA Ultimate edition. The Community Edition does not support Java EE development and cannot manage Tomcat servers. If Tomcat is not installed, download and install the appropriate version from the Apache website for your operating system.

Configuring Tomcat Server Location

Open IntelliJ IDEA, click the dropdown arrow to the left of the Run and Debug icons on the toolbar, and select Edit Configurations. In the popup window, click the Add icon, then choose Tomcat and Local. Next, click the Configure... button next to Application Server to specify the Tomcat installation directory. This step ensures IntelliJ IDEA recognizes and uses your local Tomcat server.

Creating a Web Application Project

Create a new project using the Web Application template. Place your Servlet classes in the src folder, such as a simple test Servlet. Add JSP files like index.jsp or hey.jsp in the web folder. Edit the web.xml file to configure Servlet mappings, for example, mapping a Servlet to the virtual path /st.

Deployment and Run Configuration

In the Run/Debug Configurations window, switch to the Deployment tab and select the Artifact to deploy. After applying the settings, you can start the application by clicking the Run button (or using the shortcut Shift+F10). Test your application by accessing http://localhost:8080/hey.jsp or http://localhost:8080/st in a browser.

Common Issues and Solutions

If configuration issues arise, verify the Tomcat installation path is correct and the project structure adheres to web application standards. Ensure all dependencies are properly added and the web.xml configuration is accurate. Refer to IntelliJ IDEA official documentation or community resources for additional assistance.

Copyright Notice: All rights in this article are reserved by the operators of DevGex. Reasonable sharing and citation are welcome; any reproduction, excerpting, or re-publication without prior permission is prohibited.