Apicurio Registry configuration reference
This chapter provides reference information on the configuration options that are available for Apicurio Registry.
-
For details on migrating a 2.x Apicurio Registry deployment to 3.x see Apicurio Registry version 2 to version 3 configuration changes
-
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 Configuring Kafka serializers/deserializers in Java clients.
Apicurio Registry configuration options
The following Apicurio Registry configuration options are available for each component category:
api
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Include stack trace in errors responses |
|
|
|
|
API base href (URI) |
|
|
|
Disable APIs |
auth
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Auth admin override claim |
|
|
|
|
Auth admin override claim value |
|
|
|
|
Auth admin override enabled |
|
|
|
|
Auth admin override from |
|
|
|
|
Auth admin override role |
|
|
|
|
Auth admin override type |
|
|
|
|
Auth admin override user name |
|
|
|
|
Anonymous read access |
|
|
|
|
Authenticated read access |
|
|
|
|
Artifact owner-only authorization |
|
|
|
|
Artifact group owner-only authorization |
|
|
|
|
Enable role based authorization |
|
|
|
|
Auth roles source |
|
|
|
Header authorization name |
|
|
|
|
|
Auth roles admin |
|
|
|
|
Auth roles developer |
|
|
|
|
Auth roles readonly |
|
|
|
|
Prefix used for application audit logging. |
|
|
|
|
Default client credentials token expiration time. |
|
|
|
|
Client credentials token expiration offset from JWT expiration. |
|
|
|
|
Enable basic auth client credentials |
|
|
|
Client credentials scope. |
|
|
|
|
|
Enable basic auth |
|
|
|
Client identifier used by the server for authentication. |
|
|
|
|
Client secret used by the server for authentication. |
|
|
|
|
|
Enable auth |
|
|
|
Authentication server token endpoint. |
cache
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Registry cache enabled |
ccompat
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Enable group support via concatenation in subject (compatibility API) |
|
|
|
|
Separator to use when group concatenation is enabled (compatibility API) |
|
|
|
|
Legacy ID mode (compatibility API) |
|
|
|
|
Maximum number of Subjects returned (compatibility API) |
|
|
|
|
Canonical hash mode (compatibility API) |
download
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Download link expiry |
gitops
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
Identifier of this Registry instance. Only data that references this identifier will be loaded. |
|
|
|
|
|
Name of the branch in the remote git repository containing data to be loaded. |
|
|
|
URI of the remote git repository containing data to be loaded. |
|
|
|
|
|
Path to GitOps working directory, which is used to store the local git repository. |
health
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
Ignored liveness errors |
|
|
|
|
|
Counter reset window duration of persistence liveness check |
|
|
|
|
Error threshold of persistence liveness check |
|
|
|
|
Disable logging of persistence liveness check |
|
|
|
|
Status reset window duration of persistence liveness check |
|
|
|
|
Error threshold of persistence readiness check |
|
|
|
|
Timeout of persistence readiness check |
|
|
|
|
Status reset window duration of persistence readiness check |
|
|
|
|
Counter reset window duration of response liveness check |
|
|
|
|
Counter reset window duration of persistence readiness check |
|
|
|
|
Disable logging of response liveness check |
|
|
|
|
Error threshold of response liveness check |
|
|
|
|
Status reset window duration of response liveness check |
|
|
|
|
Counter reset window duration of response readiness check |
|
|
|
|
Error threshold of response readiness check |
|
|
|
|
Timeout of response readiness check |
|
|
|
|
Status reset window duration of response readiness check |
|
|
|
|
Storage metrics cache check period |
import
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
When set to true, content IDs from the import file will be used (otherwise new IDs will be generated). Defaults to 'true'. |
|
|
|
|
When set to true, global IDs from the import file will be used (otherwise new IDs will be generated). Defaults to 'true'. |
|
|
|
|
When set to true, importing data will only work when the registry is empty. Defaults to 'true'. |
|
|
|
The import URL |
|
|
|
|
Temporary work directory to use when importing data. |
limits
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Max artifact labels |
|
|
|
|
Max artifact properties |
|
|
|
|
Max artifacts |
|
|
|
|
Max artifact description length |
|
|
|
|
Max artifact label size |
|
|
|
|
Max artifact name length |
|
|
|
|
Max artifact property key size |
|
|
|
|
Max artifact property value size |
|
|
|
|
Max artifact requests per second |
|
|
|
|
Max schema size (bytes) |
|
|
|
|
Max total schemas |
|
|
|
|
Max versions per artifacts |
|
|
|
|
Storage metrics cache max size. |
redirects
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
Registry redirects |
|
|
|
|
Enable redirects |
|
|
|
|
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. |
|
|
|
|
Override the port used for generating externally-accessible URLs. |
rest
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Max size of the artifact allowed to be downloaded from URL |
|
|
|
|
Skip SSL validation when downloading artifacts from URL |
|
|
|
|
Enables artifact version deletion |
|
|
|
|
Enables artifact deletion |
|
|
|
|
Enables group deletion |
semver
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
If true, invalid versions will be coerced to Semantic Versioning 2 format (https://semver.org) if possible. |
|
|
|
|
Automatically create or update branches for major ('A.x') and minor ('A.B.x') artifact versions. |
|
|
|
|
Validate that all artifact versions conform to Semantic Versioning 2 format (https://semver.org). |
storage
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
Gitops blue datasource db kind |
|
|
|
|
Gitops blue datasource pool initial size |
|
|
|
|
Gitops blue datasource pool max size |
|
|
|
|
Gitops blue datasource pool minimum size |
|
|
|
|
Gitops blue datasource jdbc url |
|
|
|
|
Gitops blue datasource password |
|
|
|
|
Gitops blue datasource username |
|
|
|
|
Gitops green datasource db kind |
|
|
|
|
Gitops green datasource pool initial size |
|
|
|
|
Gitops green datasource pool max size |
|
|
|
|
Gitops green datasource pool minimum size |
|
|
|
|
Gitops green datasource jdbc url |
|
|
|
|
Gitops green datasource password |
|
|
|
|
Gitops green datasource username |
|
|
|
|
Application datasource pool initial size |
|
|
|
|
Application datasource pool maximum size |
|
|
|
|
Application datasource pool minimum size |
|
|
|
|
Application datasource password |
|
|
|
|
Application datasource jdbc url |
|
|
|
|
Application datasource username |
|
|
|
Storage event topic |
|
|
|
Kafka sql storage bootstrap servers |
||
|
|
|
Kafka sql storage consumer poll timeout |
|
|
|
|
Kafka sql storage coordinator response timeout |
|
|
|
Kafka sql storage security protocol |
||
|
|
Kafka sql storage sasl client identifier |
||
|
|
Kafka sql storage sasl client secret |
||
|
|
|
Kafka sql storage sasl enabled |
|
|
|
Kafka sql storage sasl login callback handler |
||
|
|
Kafka sql storage sasl mechanism |
||
|
|
Kafka sql storage sasl token endpoint |
||
|
|
Kafka sql storage ssl truststore location |
||
|
|
Kafka sql storage ssl truststore type |
||
|
|
|
|
Kafka sql journal topic snapshot every |
|
|
|
|
Kafka sql storage topic name |
|
|
Kafka sql storage ssl key password |
||
|
|
Kafka sql storage ssl keystore location |
||
|
|
Kafka sql storage ssl keystore password |
||
|
|
Kafka sql storage ssl keystore type |
||
|
|
Kafka sql storage ssl truststore password |
||
|
|
|
Kafka sql storage topic name |
|
|
|
|
Kafka sql storage topic auto create |
|
|
|
|
|
SQL init |
|
|
|
Application storage variant, for example, sql, kafkasql, or gitops |
|
|
|
|
|
Enable Registry storage read-only mode |
|
|
|
|
Kafka sql snapshots store location |
|
|
|
|
Application datasource database type |
|
|
|
|
Skip artifact versions with DISABLED state when retrieving latest artifact version |
ui
Name | Type | Default | Available from | Description |
---|---|---|---|---|
|
|
|
|
The OIDC clientId |
|
|
|
|
The OIDC logout URL |
|
|
|
|
The OIDC redirectUri |
|
|
|
|
Context path of the UI |
|
|
|
|
URL of the Documentation component |
|
|
|
|
Enabled to show breadcrumbs in the UI |
|
|
|
|
Enabled to set the UI to read-only mode |
|
|
|
|
Enabled to show the Settings tab in the UI |
|
|
|
|
Navigation prefix for all UI paths |
Apicurio Registry version 2 to version 3 configuration changes
Apicurio Registry v3 has simplified the configuration options, removing duplicates and improving consistency.
For most options, the only change is ssrenaming of the prefix from registry
to apicurio
, for example, changing registry.kafkasql.bootstrap.servers
to apicurio.kafkasql.bootstrap.servers
.
For each configuration property you can override the value by using the corresponding environment variable, for example, APICURIO_KAFKA_SQL_BOOTSTRAP_SERVERS .s
|
api
Name | New Option |
---|---|
|
|
|
|
auth
Name | New Option |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
cache
Name | New Option |
---|---|
|
|
ccompat
Name | New Option |
---|---|
|
|
|
|
|
|
download
Name | New Option |
---|---|
|
|
health
Name | New Option |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
import
Name | New Option |
---|---|
|
|
kafka
Name | New Option |
---|---|
|
|
|
|
limits
Name | New Option |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
redirects
Name | New Option |
---|---|
|
|
|
|
|
|
|
|
rest
Name | New Option |
---|---|
|
|
|
|
|
|
store
Name | New Option |
---|---|
|
|
|
|
ui
Name | New Option |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|