Chapter 1.5☕ 14 min read

Setup Eclipse STS

Free, open-source, and enterprise-proven for decades.

01The Concept: Eclipse & STS

The Old City Heritage House Analogy:

Eclipse is like buying an old heritage house in the Old City of Hyderabad. The structure is solid, it has been around for decades, and everyone knows it. But out of the box, it doesn't have modern appliances.

To make it comfortable, you need to install Spring Tools Suite (STS) plugins. STS is just Eclipse pre-packaged with Spring Boot dashboards, auto-completion for Spring annotations, and a dedicated "Boot Dashboard" to start/stop your applications easily.

02What is Spring Tools Suite?

Spring Tools Suite (STS) is a customized version of Eclipse specifically for Spring development. It adds:

  • Boot Dashboard: Start, stop, and restart Spring Boot apps with one click
  • Smart auto-completion: For application.properties, annotations, and beans
  • Live bean visualization: See your Spring context in real-time
  • Built-in terminal: Run Maven/Gradle commands without switching windows

STS is free — making it the go-to choice for universities and cost-conscious enterprises.

03Step-by-Step: Running in Eclipse/STS
  1. Download and open Eclipse IDE for Enterprise Java and Web Developers (or download STS directly from spring.io/tools).
  2. Go to File → Import.
  3. Select Maven → Existing Maven Projects and click Next.
  4. Browse to the root folder of your Spring Boot project and click Finish.
  5. Eclipse takes a minute to build the workspace and download dependencies.
  6. In the Project Explorer, expand my-first-app → src/main/java → com.devinhyderabad.
  7. Right-click on Application.java.
  8. Select Run As → Java Application.
  9. The Console tab will display the Spring Boot leaf logo and show "Started Application in X seconds".
04Common Pitfall: Port Already in Use

Port Already in Use Error

If you get a "Port 8080 already in use" error in Eclipse:

  1. Go to the Console toolbar and click the red Stop button to kill the previous run.
  2. Alternatively, change the server port in application.properties: server.port=9090.
  3. Then re-run the application.
05Why It Matters / Enterprise Note

Enterprise Note: While IntelliJ is the developer favorite, you will often encounter CI/CD pipelines, legacy banking systems, or restricted client environments where Eclipse is the only approved IDE due to its free, open-source nature. Knowing how to import and run Maven projects in Eclipse is a basic survival skill in enterprise Java.

Key Takeaways

  • ✅ Eclipse + STS is free, open-source, and widely used in enterprise
  • ✅ Import as Existing Maven Project — Eclipse auto-resolves dependencies
  • ✅ Run As → Java Application from Application.java context menu
  • ✅ Knowledge of Eclipse is essential for legacy enterprise environments