skills.rest
jvm-skills
jvm-skillsOFFICIAL
Explore all skills by this author →
GitHub

restart-spring-boot

Restart Spring Boot apps via IntelliJ run configurations and wait for health checks.

135|25|Updated Feb 20, 2026
Search Tags:#restart#kotlin#jetbrains#spring-boot#health-check#intellij
One-click install
npx skills add https://github.com/jvm-skills/jvm-skills --skill restart-spring-boot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: restart-spring-boot
Source: https://github.com/jvm-skills/jvm-skills/tree/main/.junie/skills/restart-spring-boot
Command: npx skills add https://github.com/jvm-skills/jvm-skills --skill restart-spring-boot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Restart the Spring Boot app after Kotlin changes and ensure the server is fully ready before continuing.

Core Features & Use Cases

  • Stop the old app and wait for the port to be released.
  • Start the app via an IntelliJ JetBrains MCP run configuration and identify the correct configuration name.
  • Wait for readiness by polling a health endpoint (e.g., /actuator/health or root) and verify logs if a post-restart hook exists.
  • Project customization is guided by references/project.md for port, run configuration name, and log paths.

Quick Start

Copy SKILL.md into your project, move templates/restart-app.sh to scripts/restart-app.sh, make it executable, and run ./scripts/restart-app.sh to perform a full restart.

Frequently Asked Questions about restart-spring-boot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restart a Spring Boot application and wait for it to be ready?▼

To restart a Spring Boot application and ensure readiness, stop the old process, wait for the port to release, launch the IntelliJ run configuration, and poll the health endpoint until it passes.

How do I restart a Kotlin Spring Boot app using an IntelliJ run configuration?▼

You can restart a Kotlin Spring Boot app by executing a scripted restart flow that identifies and launches the correct IntelliJ JetBrains run configuration, then verifies readiness through health checks and logs.

What health check endpoint does the Spring Boot restart process poll for readiness?▼

The Spring Boot restart process polls the /actuator/health endpoint or the root endpoint to verify server readiness and reports success or failure based on the health endpoint response and application logs.

Do I need to configure project-specific settings to restart my Spring Boot application?▼

Yes, you need to configure project-specific context via references/project.md, which guides customization for the port number, IntelliJ run configuration name, and log paths used during the Spring Boot restart flow.

Why does my Spring Boot restart fail after Kotlin changes even when the port is released?▼

A Spring Boot restart can fail after Kotlin changes if the health endpoint does not pass or post-restart logs indicate errors, causing the readiness check to report failure despite the old process stopping and the port releasing correctly.

Related Skills

Explore More Software Engineering Skills→
chartsaichartsai

springboot-ide-setup

Configure IntelliJ IDEA for Spring Boot projects with JDK, plugins, and run configuration.

Community
Intermediate
semicolon-devteamsemicolon-devteam

coverage-guide

Executes Gradle builds and collects JVM-based project coverage with Surefire/Failsafe reports.

Official
Advanced
arrowInkneeeeearrowInkneeeee
1

health-check-designer

Configure Spring Boot Actuator health checks and monitoring endpoints.

Community
Intermediate
sensei-hackersensei-hacker
4

run-configurator

Launch the INAV Configurator Electron app in development mode with hot-reload.

Community
Intermediate