{"record":{"id":"bdf08777d8d2e7a9","repo":"quarkusio/quarkus","slug":"invalid-configuration-quarkus-management-port-m-bdf087","errorCode":null,"errorMessage":"Invalid configuration: `quarkus.management.port` must be different from `quarkus.http.ssl-port`.","messagePattern":"Invalid configuration: `quarkus\\.management\\.port` must be different from `quarkus\\.http\\.ssl-port`\\.","errorType":"validation","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"extensions/vertx-http/runtime/src/main/java/io/quarkus/vertx/http/runtime/VertxHttpRecorder.java","lineNumber":1155,"sourceCode":"        if (!managementBuildTimeConfig.enabled() || managementConfig == null || !managementConfig.hostEnabled()) {\n            return;\n        }\n\n        int managementPort = managementConfig.determinePort(launchMode);\n        if (managementPort <= 0) {\n            // 0 means random port, so it can't be validated against fixed ports here\n            return;\n        }\n\n        int httpPort = httpConfig.hostEnabled() ? httpConfig.determinePort(launchMode) : -1;\n        if (httpPort > 0 && httpPort == managementPort) {\n            throw new IllegalStateException(\n                    \"Invalid configuration: `quarkus.management.port` must be different from `quarkus.http.port`.\");\n        }\n\n        int httpsPort = httpConfig.determineSslPort(launchMode);\n        if (httpsPort > 0 && httpsPort == managementPort) {\n            throw new IllegalStateException(\n                    \"Invalid configuration: `quarkus.management.port` must be different from `quarkus.http.ssl-port`.\");\n        }\n    }\n\n    private static void setHttpServerTiming(boolean httpDisabled, HttpServerConfig httpServerConfig,\n            HttpServerConfig sslConfig,\n            HttpServerConfig domainSocketConfig, boolean auxiliaryApplication, HttpServerConfig managementConfig) {\n        StringBuilder serverListeningMessage = new StringBuilder(\"Listening on: \");\n        int socketCount = 0;\n\n        if (!httpDisabled && httpServerConfig != null) {\n            serverListeningMessage.append(String.format(\n                    \"http://%s:%s\", getDeveloperFriendlyHostName(httpServerConfig), actualHttpPort));\n            socketCount++;\n        }\n\n        if (sslConfig != null) {\n            if (socketCount > 0) {","sourceCodeStart":1137,"sourceCodeEnd":1173,"githubUrl":"https://github.com/quarkusio/quarkus/blob/e1c734241f34c7919086ceb4c9262b4a58f6de44/extensions/vertx-http/runtime/src/main/java/io/quarkus/vertx/http/runtime/VertxHttpRecorder.java#L1137-L1173","documentation":"VertxHttpRecorder also validates that the management port does not equal the resolved HTTPS port (quarkus.http.ssl-port); when both servers would bind the same port, startup fails with this IllegalStateException. Like the HTTP check, random ports (0) are not validated.","triggerScenarios":"quarkus.management.port equals the value resolved from quarkus.http.ssl-port (both positive) while the management interface is enabled and SSL is configured.","commonSituations":"Same numeric value for management.port and http.ssl-port; TLS setup where the management interface inherited the HTTPS port; profile or env overrides making ssl-port coincide with the management port.","solutions":["Set quarkus.management.port to a value different from quarkus.http.ssl-port","Or set quarkus.management.port=0 for a random port","Review active profile and env vars that could set ssl-port equal to the management port"],"exampleFix":"// before\nquarkus.http.ssl-port=8443\nquarkus.management.port=8443\n// after\nquarkus.http.ssl-port=8443\nquarkus.management.port=9001","handlingStrategy":"validation","validationCode":"if (managementPort > 0 && managementPort == sslPort) {\n    throw new IllegalStateException(\"quarkus.management.port must differ from quarkus.http.ssl-port\");\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep management.port distinct from both http.port and http.ssl-port","Audit TLS configs for copied ports","Prefer a random (0) management port in CI"],"tags":["config","startup","port-conflict","ssl","management"],"backgroundTag":"port-conflict","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"}