+
+
+
There are two paths from Spring to Quarkus. You can use compatibility libraries to run your existing Spring code on Quarkus with minimal changes — same annotations, same patterns, faster runtime. Or you can migrate to native Quarkus APIs (Jakarta REST, CDI, Panache) to get the most out of Quarkus. Either way, you don't have to do it all at once: start with compatibility, then migrate incrementally as it suits you. Both paths are supported by tooling and AI to help automate the work.
+
+
+
+
Compatibility Libraries
+
Spring APIs that work on Quarkus, out of the box
+
Quarkus provides compatibility extensions that let you reuse your Spring knowledge and code. Use familiar annotations like @RestController, @Autowired, and JpaRepository on a leaner, more productive runtime.
+
To get started: swap in the Quarkus Maven plugin and BOM, add the compatibility extensions you need, and update your property names in application.properties to their Quarkus equivalents.
+
+
These extensions cover the most widely used Spring APIs, but not all of them. If your application uses Spring features that aren't listed here, you'll need to migrate those parts to their Quarkus equivalents — the tooling and AI resources below can help with that.
+
Browse all Spring guides
+
+
+
+
Migrate
+
From analysis to automation
+
+
Tooling
+
+
+
+
+
Migration Toolkit for Applications (MTA)
+
Red Hat's rule-based analysis tool, built on the Konveyor open source project. MTA analyses your Spring Boot application and produces detailed reports highlighting what needs to change, with guidance on how to fix each issue. Available as a web console, CLI, Maven plugin, or IDE plugin.
+
Read the MTA migration story
+
+
+
+
+
+
+
OpenRewrite
+
The SpringBootToQuarkus composite recipe automates dependency swaps, annotation changes, and configuration migration. Run it via Maven, Gradle, or the CLI with no build changes needed.
+
OpenRewrite Spring-to-Quarkus recipes
+
+
+
+
+
+
+
+
+
Snowdrop Migration Guide
+
A structured guide with rules and decision flowcharts for migrating Spring Boot 3.x to Quarkus 3.x. Supports two paths: full Quarkus (Jakarta REST/CDI) or Spring compatibility (quarkus-spring-* extensions). Includes Konveyor analysis rules.
+
Snowdrop migration guide on GitHub
+
+
+
+
+
+
AI
+
+
+
+
+
AI-Assisted Migration
+
Modern AI coding assistants understand both Spring and Quarkus patterns well. They can help translate controllers, services, repositories, configuration files, build files, and tests — giving you a head start on each file you need to migrate. For a hands-on walkthrough of what a full migration looks like step by step, see Markus Eisele's guide on The Main Thread, or you can get started with a prompt like "Convert this Spring Boot app to Quarkus".
+
+
+
+
+
+
+
Konveyor AI (Kai)
+
Combines generative AI with static code analysis to assist migration directly in your IDE. Uses a RAG-based approach with historical migration data to provide context-specific guidance, without requiring model fine-tuning.
+
Learn about Konveyor AI
+
+
+
+
+
+
+
+
+
Quarkus Spring Migration Skill
+
To help ensure optimum results and efficiency when using LLMs, we've developed skills. The `quarkus-skills` migration skill guides an AI agent through a full Spring Boot to Quarkus migration — from reading the codebase to committing the result and opening a draft PR. It inspects your project and decides which modules apply, adapting to your chosen strategy: Spring Compatibility or Native Quarkus.
+
Quarkus Skills on GitHub
+
+
+
+
+
+
+
+
For more guidance, the free Quarkus for Spring Developers e-book explains the similarities and differences between the two frameworks, and helps you map Spring Boot concepts to their Quarkus equivalents.
+
+
+
Using Spring now? you don’t have to start over.
+
Using Spring now? you don’t have to start over.
Quarkus speaks fluent Spring. Reuse your @RestController, @Autowired, and JpaRepository code with Spring compatibility extensions. You get the same familiar APIs, now backed by a faster, more modern runtime.
-
Start your journey with these excellent Spring guides
+
Ready to migrate? See our migration guide
diff --git a/_layouts/contentwithbreadcrumb.html b/_layouts/contentwithbreadcrumb.html
deleted file mode 100644
index aa626c966e8..00000000000
--- a/_layouts/contentwithbreadcrumb.html
+++ /dev/null
@@ -1,19 +0,0 @@
----
-layout: base
----
-
-
-
-
diff --git a/_layouts/migratetoquarkus.html b/_layouts/migratetoquarkus.html
deleted file mode 100644
index ec737075159..00000000000
--- a/_layouts/migratetoquarkus.html
+++ /dev/null
@@ -1,8 +0,0 @@
----
-layout: base
----
-
-{% include title-band.html %}
-
-{% include spring-migrate-main.html %}
-{% include spring-migrate-books.html %}
diff --git a/_layouts/spring-migrate.html b/_layouts/spring-migrate.html
new file mode 100644
index 00000000000..44f86b6a872
--- /dev/null
+++ b/_layouts/spring-migrate.html
@@ -0,0 +1,8 @@
+---
+layout: base
+---
+
+{% include spring-breadcrumb.html %}
+{% include springtitle-band.html %}
+
+{% include spring-migrate-content.html %}
diff --git a/_redirects/migrate-to-quarkus.md b/_redirects/migrate-to-quarkus.md
new file mode 100644
index 00000000000..e10ee600ed7
--- /dev/null
+++ b/_redirects/migrate-to-quarkus.md
@@ -0,0 +1,4 @@
+---
+permalink: /migrate-to-quarkus/
+newUrl: /spring/migrate
+---
diff --git a/migrate-to-quarkus.md b/migrate-to-quarkus.md
deleted file mode 100644
index 5edcf15223f..00000000000
--- a/migrate-to-quarkus.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-layout: migratetoquarkus
-title: Migrate from Spring to Quarkus
-permalink: /migrate-to-quarkus/
-subtitle: From Spring to Quarkus, One Line at a Time
-
----
diff --git a/spring-migrate.md b/spring-migrate.md
new file mode 100644
index 00000000000..915a5ceffb4
--- /dev/null
+++ b/spring-migrate.md
@@ -0,0 +1,7 @@
+---
+layout: spring-migrate
+title: Migrate from Spring to Quarkus
+permalink: /spring/migrate/
+subtitle: Everything You Need to Move to Quarkus
+
+---
- 
- 
- 
- 
- 
- 
-