Swagger UI missing in Prod for Quarkus App

Question

From the Quarkus docs, quarkus.swagger-ui.always-include=true must be set in the application.properties for SwaggerUI to be built in prod.

By default, Swagger UI is only available when Quarkus is started in dev or test mode.

However, even with the property set, Swagger UI is still not built with the app.

• mvn clean compile quarkus:dev

2024-03-25 17:46:29,725 INFO  [io.quarkus] (Quarkus Main Thread) test-process 1.0.0-SNAPSHOT on JVM (powered by Quarkus 2.16.10.Final) started in 11.997s. Listening on: http://localhost:8080
2024-03-25 17:46:29,725 INFO  [io.quarkus] (Quarkus Main Thread) Profile dev activated. Live Coding activated.
2024-03-25 17:46:29,725 INFO  [io.quarkus] (Quarkus Main Thread) Installed features: [cdi, kogito-addon-persistence-rocksdb-extension, kogito-addon-process-svg-extension, kogito-decisions, kogito-predictions, kogito-processes, kogito-rules, resteasy, resteasy-jackson, security, smallrye-context-propagation, smallrye-health, smallrye-openapi, swagger-ui, vertx]

• mvn clean package; java -jar target/quarkus-app/quarkus-run.jar

2024-03-25 18:05:44,862 INFO  [io.quarkus] (main) test-process 1.0.0-SNAPSHOT on JVM (powered by Quarkus 2.16.10.Final) started in 1.247s. Listening on: http://0.0.0.0:8080
2024-03-25 18:05:44,862 INFO  [io.quarkus] (main) Profile prod activated. 
2024-03-25 18:05:44,862 INFO  [io.quarkus] (main) Installed features: [cdi, kogito-addon-persistence-rocksdb-extension, kogito-addon-process-svg-extension, kogito-decisions, kogito-predictions, kogito-processes, kogito-rules, resteasy, resteasy-jackson, security, smallrye-context-propagation, smallrye-health, smallrye-openapi, vertx]

Note the missing feature smallrye-openapi, {swagger-ui}, vertx]

Here is my application.properties

# Set up for the swagger-ui (Process-defintions)
quarkus.smallrye-openapi.path=/api
quarkus.swagger-ui.always-include=true
quarkus.swagger-ui.path=/swagger

---

Edit: I copied the project to a public repo. Here's the pom.xml

Answer 1

I can not recreate the issue you describe here. When I configure an app as you described here, it starts up with:

2024-03-26 17:01:35,811 INFO  [io.quarkus] (main) code-with-quarkus 1.0.0-SNAPSHOT on JVM (powered by Quarkus 3.8.3) started in 0.629s. Listening on: http://0.0.0.0:8080
2024-03-26 17:01:35,817 INFO  [io.quarkus] (main) Profile prod activated. 
2024-03-26 17:01:35,817 INFO  [io.quarkus] (main) Installed features: [cdi, resteasy-reactive, smallrye-context-propagation, smallrye-openapi, swagger-ui, vertx]

I see you are using a fairly old Quarkus: (2.16.10.Final). Saying that, this feature has been available since pre 1 release.

Does the UI or schema document also not render/download ?

Answer 2

This is how I use it on our production & non-production environment, to actually enable/disable swagger-ui:

quarkus.swagger-ui.enable=true/false

And this works.