Chapter 8. Service Registry configuration reference This chapter provides reference information on the configuration options that are available for Service Registry. Section 8.1, "Service Registry configuration options" Additional resources For details on setting configuration options by using the Core Registry API, see the /admin/config/properties endpoint in the Apicurio Registry REST API documentation . For details on client configuration options for Kafka serializers and deserializers, see the Service Registry User Guide . 8.1. Service Registry configuration options The following Service Registry configuration options are available for each component category: 8.1.1. api Table 8.1. api configuration options Name Type Default Available from Description registry.api.errors.include-stack-in-response boolean false 2.1.4.Final Include stack trace in errors responses registry.disable.apis optional<list<string>> 2.0.0.Final Disable APIs 8.1.2. auth Table 8.2. auth configuration options Name Type Default Available from Description registry.auth.admin-override.claim string org-admin 2.1.0.Final Auth admin override claim registry.auth.admin-override.claim-value string true 2.1.0.Final Auth admin override claim value registry.auth.admin-override.enabled boolean false 2.1.0.Final Auth admin override enabled registry.auth.admin-override.from string token 2.1.0.Final Auth admin override from registry.auth.admin-override.role string sr-admin 2.1.0.Final Auth admin override role registry.auth.admin-override.type string role 2.1.0.Final Auth admin override type registry.auth.anonymous-read-access.enabled boolean [dynamic] false 2.1.0.Final Anonymous read access registry.auth.audit.log.prefix string audit 2.2.6 Prefix used for application audit logging. registry.auth.authenticated-read-access.enabled boolean [dynamic] false 2.1.4.Final Authenticated read access registry.auth.basic-auth-client-credentials.cache-expiration integer 10 2.2.6.Final Client credentials token expiration time. registry.auth.basic-auth-client-credentials.enabled boolean [dynamic] false 2.1.0.Final Enable basic auth client credentials registry.auth.basic-auth.scope optional<string> 2.5.0.Final Client credentials scope. registry.auth.client-id string 2.0.0.Final Client identifier used by the server for authentication. registry.auth.client-secret optional<string> 2.1.0.Final Client secret used by the server for authentication. registry.auth.enabled boolean false 2.0.0.Final Enable auth registry.auth.owner-only-authorization boolean [dynamic] false 2.0.0.Final Artifact owner-only authorization registry.auth.owner-only-authorization.limit-group-access boolean [dynamic] false 2.1.0.Final Artifact group owner-only authorization registry.auth.role-based-authorization boolean false 2.1.0.Final Enable role based authorization registry.auth.role-source string token 2.1.0.Final Auth roles source registry.auth.role-source.header.name string 2.4.3.Final Header authorization name registry.auth.roles.admin string sr-admin 2.0.0.Final Auth roles admin registry.auth.roles.developer string sr-developer 2.1.0.Final Auth roles developer registry.auth.roles.readonly string sr-readonly 2.1.0.Final Auth roles readonly registry.auth.tenant-owner-is-admin.enabled boolean true 2.1.0.Final Auth tenant owner admin enabled registry.auth.token.endpoint string 2.1.0.Final Authentication server url. 8.1.3. cache Table 8.3. cache configuration options Name Type Default Available from Description registry.config.cache.enabled boolean true 2.2.2.Final Registry cache enabled 8.1.4. ccompat Table 8.4. ccompat configuration options Name Type Default Available from Description registry.ccompat.legacy-id-mode.enabled boolean [dynamic] false 2.0.2.Final Legacy ID mode (compatibility API) registry.ccompat.max-subjects integer [dynamic] 1000 2.4.2.Final Maximum number of Subjects returned (compatibility API) registry.ccompat.use-canonical-hash boolean [dynamic] false 2.3.0.Final Canonical hash mode (compatibility API) 8.1.5. download Table 8.5. download configuration options Name Type Default Available from Description registry.download.href.ttl long [dynamic] 30 2.1.2.Final Download link expiry 8.1.6. events Table 8.6. events configuration options Name Type Default Available from Description registry.events.ksink optional<string> 2.0.0.Final Events Kafka sink enabled 8.1.7. health Table 8.7. health configuration options Name Type Default Available from Description registry.liveness.errors.ignored optional<list<string>> 1.2.3.Final Ignored liveness errors registry.metrics.PersistenceExceptionLivenessCheck.counterResetWindowDurationSec integer 60 1.0.2.Final Counter reset window duration of persistence liveness check registry.metrics.PersistenceExceptionLivenessCheck.disableLogging boolean false 2.0.0.Final Disable logging of persistence liveness check registry.metrics.PersistenceExceptionLivenessCheck.errorThreshold integer 1 1.0.2.Final Error threshold of persistence liveness check registry.metrics.PersistenceExceptionLivenessCheck.statusResetWindowDurationSec integer 300 1.0.2.Final Status reset window duration of persistence liveness check registry.metrics.PersistenceTimeoutReadinessCheck.counterResetWindowDurationSec integer 60 1.0.2.Final Counter reset window duration of persistence readiness check registry.metrics.PersistenceTimeoutReadinessCheck.errorThreshold integer 5 1.0.2.Final Error threshold of persistence readiness check registry.metrics.PersistenceTimeoutReadinessCheck.statusResetWindowDurationSec integer 300 1.0.2.Final Status reset window duration of persistence readiness check registry.metrics.PersistenceTimeoutReadinessCheck.timeoutSec integer 15 1.0.2.Final Timeout of persistence readiness check registry.metrics.ResponseErrorLivenessCheck.counterResetWindowDurationSec integer 60 1.0.2.Final Counter reset window duration of response liveness check registry.metrics.ResponseErrorLivenessCheck.disableLogging boolean false 2.0.0.Final Disable logging of response liveness check registry.metrics.ResponseErrorLivenessCheck.errorThreshold integer 1 1.0.2.Final Error threshold of response liveness check registry.metrics.ResponseErrorLivenessCheck.statusResetWindowDurationSec integer 300 1.0.2.Final Status reset window duration of response liveness check registry.metrics.ResponseTimeoutReadinessCheck.counterResetWindowDurationSec instance<integer> 60 1.0.2.Final Counter reset window duration of response readiness check registry.metrics.ResponseTimeoutReadinessCheck.errorThreshold instance<integer> 1 1.0.2.Final Error threshold of response readiness check registry.metrics.ResponseTimeoutReadinessCheck.statusResetWindowDurationSec instance<integer> 300 1.0.2.Final Status reset window duration of response readiness check registry.metrics.ResponseTimeoutReadinessCheck.timeoutSec instance<integer> 10 1.0.2.Final Timeout of response readiness check registry.storage.metrics.cache.check-period long 30000 2.1.0.Final Storage metrics cache check period 8.1.8. import Table 8.8. import configuration options Name Type Default Available from Description registry.import.url optional<url> 2.1.0.Final The import URL 8.1.9. kafka Table 8.9. kafka configuration options Name Type Default Available from Description registry.events.kafka.topic optional<string> 2.0.0.Final Events Kafka topic registry.events.kafka.topic-partition optional<integer> 2.0.0.Final Events Kafka topic partition 8.1.10. limits Table 8.10. limits configuration options Name Type Default Available from Description registry.limits.config.max-artifact-labels long -1 2.2.3.Final Max artifact labels registry.limits.config.max-artifact-properties long -1 2.1.0.Final Max artifact properties registry.limits.config.max-artifacts long -1 2.1.0.Final Max artifacts registry.limits.config.max-description-length long -1 2.1.0.Final Max artifact description length registry.limits.config.max-label-size long -1 2.1.0.Final Max artifact label size registry.limits.config.max-name-length long -1 2.1.0.Final Max artifact name length registry.limits.config.max-property-key-size long -1 2.1.0.Final Max artifact property key size registry.limits.config.max-property-value-size long -1 2.1.0.Final Max artifact property value size registry.limits.config.max-requests-per-second long -1 2.2.3.Final Max artifact requests per second registry.limits.config.max-schema-size-bytes long -1 2.2.3.Final Max schema size (bytes) registry.limits.config.max-total-schemas long -1 2.1.0.Final Max total schemas registry.limits.config.max-versions-per-artifact long -1 2.1.0.Final Max versions per artifacts registry.storage.metrics.cache.max-size long 1000 2.4.1.Final Storage metrics cache max size. 8.1.11. log Table 8.11. log configuration options Name Type Default Available from Description quarkus.log.level string 2.0.0.Final Log level 8.1.12. redirects Table 8.12. redirects configuration options Name Type Default Available from Description registry.enable-redirects boolean 2.1.2.Final Enable redirects registry.redirects map<string, string> 2.1.2.Final Registry redirects registry.url.override.host optional<string> 2.5.0.Final Override the hostname used for generating externally-accessible URLs. The host and port overrides are useful when deploying Registry with HTTPS passthrough Ingress or Route. In cases like these, the request URL (and port) that is then re-used for redirection does not belong to actual external URL used by the client, because the request is proxied. The redirection then fails because the target URL is not reachable. registry.url.override.port optional<integer> 2.5.0.Final Override the port used for generating externally-accessible URLs. 8.1.13. rest Table 8.13. rest configuration options Name Type Default Available from Description registry.rest.artifact.deletion.enabled boolean [dynamic] false 2.4.2-SNAPSHOT Enables artifact version deletion registry.rest.artifact.download.maxSize int 1000000 2.2.6-SNAPSHOT Max size of the artifact allowed to be downloaded from URL registry.rest.artifact.download.skipSSLValidation boolean false 2.2.6-SNAPSHOT Skip SSL validation when downloading artifacts from URL 8.1.14. store Table 8.14. store configuration options Name Type Default Available from Description artifacts.skip.disabled.latest boolean true 2.4.2-SNAPSHOT Skip artifact versions with DISABLED state when retrieving latest artifact version quarkus.datasource.db-kind string postgresql 2.0.0.Final Datasource Db kind quarkus.datasource.jdbc.url string 2.1.0.Final Datasource jdbc URL registry.sql.init boolean true 2.0.0.Final SQL init 8.1.15. ui Table 8.15. ui configuration options Name Type Default Available from Description quarkus.oidc.tenant-enabled boolean false 2.0.0.Final UI OIDC tenant enabled registry.ui.config.apiUrl string 1.3.0.Final UI APIs URL registry.ui.config.auth.oidc.client-id string none 2.2.6.Final UI auth OIDC client ID registry.ui.config.auth.oidc.redirect-url string none 2.2.6.Final UI auth OIDC redirect URL registry.ui.config.auth.oidc.url string none 2.2.6.Final UI auth OIDC URL registry.ui.config.auth.type string none 2.2.6.Final UI auth type registry.ui.config.uiCodegenEnabled boolean true 2.4.2.Final UI codegen enabled registry.ui.config.uiContextPath string /ui/ 2.1.0.Final UI context path registry.ui.features.readOnly boolean [dynamic] false 1.2.0.Final UI read-only mode registry.ui.features.settings boolean false 2.2.2.Final UI features settings registry.ui.root string 2.3.0.Final Overrides the UI root context (useful when relocating the UI context using an inbound proxy)

Commands: