{"record":{"id":"18ede8e45154fa01","repo":"quarkusio/quarkus","slug":"hot-deployment-of-the-application-is-not-supported","errorCode":null,"errorMessage":"Hot deployment of the application is not supported when updating the Quarkus version. The application needs to be stopped and dev mode started up again","messagePattern":"Hot deployment of the application is not supported when updating the Quarkus version\\. The application needs to be stopped and dev mode started up again","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"core/deployment/src/main/java/io/quarkus/deployment/dev/IsolatedDevModeMain.java","lineNumber":339,"sourceCode":"        restarting = true;\n        if (codeGenWatcher != null) {\n            codeGenWatcher.shutdown();\n            codeGenWatcher = null;\n        }\n\n        for (int i = listeners.size() - 1; i >= 0; i--) {\n            try {\n                listeners.get(i).beforeShutdown();\n            } catch (Exception e) {\n                log.warn(\"Unable to invoke 'beforeShutdown' of \" + listeners.get(i).getClass(), e);\n            }\n        }\n        listeners.clear();\n\n        try {\n            stop();\n            if (RuntimeUpdatesProcessor.INSTANCE == null) {\n                throw new IllegalStateException(\n                        \"Hot deployment of the application is not supported when updating the Quarkus version. The application needs to be stopped and dev mode started up again\");\n            }\n        } finally {\n            try {\n                if (RuntimeUpdatesProcessor.INSTANCE != null) {\n                    try {\n                        RuntimeUpdatesProcessor.INSTANCE.close();\n                    } catch (IOException e) {\n                        log.error(\"Failed to close compiler\", e);\n                    } finally {\n                        RuntimeUpdatesProcessor.INSTANCE = null;\n                    }\n                }\n                for (HotReplacementSetup i : hotReplacementSetups) {\n                    i.close();\n                }\n                hotReplacementSetups.clear();\n            } finally {","sourceCodeStart":321,"sourceCodeEnd":357,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/core/deployment/src/main/java/io/quarkus/deployment/dev/IsolatedDevModeMain.java#L321-L357","documentation":"IsolatedDevModeMain.close() stops dev mode and relies on RuntimeUpdatesProcessor.INSTANCE to support hot redeployment. When hot-reload support was never installed (INSTANCE is null) — which happens when the Quarkus version changed and the application is being restarted in place — hot deployment cannot continue, so this IllegalStateException is thrown asking you to fully stop and restart dev mode.","triggerScenarios":"Changing the Quarkus version and triggering a hot redeploy/restart in an already-running dev mode session; close() invoked by firstStart/run/accept with RuntimeUpdatesProcessor.INSTANCE still null.","commonSituations":"Editing pom.xml/build.gradle to bump the Quarkus version while quarkus:dev is running; the dev mode restart handler attempting an in-place reload across a version boundary.","solutions":["Stop dev mode completely (Ctrl+C / stop the build tool process).","Start dev mode again with ./mvnw quarkus:dev (or gradle quarkusDev) after the version change.","Perform a clean build after upgrading Quarkus to avoid stale augmented artifacts."],"exampleFix":"// before: while quarkus:dev is running\n<quarkus.platform.version>3.15.0</quarkus.platform.version>  // hot reload picks this up -> error\n\n// after: stop dev mode first, then change version and run\n./mvnw clean\n./mvnw quarkus:dev","handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"try {\n    // trigger redeploy\n} catch (IllegalStateException e) {\n    if (e.getMessage().contains(\"Hot deployment\")) {\n        // stop dev mode fully and restart quarkus:dev\n    }\n}","preventionTips":["Never bump the Quarkus version while dev mode is running; stop first.","Restart dev mode after any dependency version change.","Use clean builds when upgrading the platform."],"tags":["quarkus","dev-mode","hot-reload","live-reload"],"backgroundTag":"unsupported-hot-reload","analyzedSha":"e1c734241f34c7919086ceb4c9262b4a58f6de44","analyzedAt":"2026-09-05T17:01:29.979Z","contentChangedAt":"2026-09-05T17:01:29.979Z","schemaVersion":2},"datasetVersion":"2026-09-12T22:17:10.623Z"}