Apicurio Schema Registry

Apicurio Schema Registry provides schema storage and validation for Kafka client applications. It is the preferred Schema Registry in the Axual Platform, supporting Avro, Protobuf, and JSON Schema formats, as well as both BasicAuth and OAuth authentication for SerDes clients.

Apicurio Registry v3 is the current, recommended version in the Platform.

Apicurio Registry v2 (2.6.x) is still supported in 2026.2 but is deprecated and will be removed in 2026.3. For its documentation see Apicurio Schema Registry v2, and to move to v3 follow Upgrade Apicurio v2 to Apicurio v3.

Schema Types

Apicurio supports the following schema formats:

Avro — recommended; native Kafka fit, flexible schema evolution
Protobuf — suited for RPC and microservices integrations
JSON Schema — suitable for API validation use cases

For a detailed comparison of schema formats and serialization guidance, see Selecting Data Formats.

For Developers

Selecting Data Formats — Schema format comparison, SerDes configuration and encoding strategies
Schema Registry Authentication for SerDes — configuring BasicAuth and OAuth on Apicurio SerDes clients
Schema Management — uploading and managing schemas in Self-Service

Java examples demonstrating serializer and deserializer usage are available in the public client-java-examples repository.

For Instance Admins

Instance Schema Registry Configuration — configure Apicurio as the Schema Registry for an Instance
Client Authentication support for an Instance — enable BasicAuth for SerDes clients

For Operators

Configuring Apicurio — deployment, Kafka integration, TLS, and OAuth Auth Proxy setup
Keycloak Realm Setup — configuring Keycloak for Apicurio authentication
Migrating to Apicurio — migration guide from Confluent Schema Registry

API

For detailed API information, refer to the official Apicurio Registry API documentation.

Helm Chart Reference

Changelog & Readme

Changelog