Examples Catalog
A collection of YAML manifests and configuration examples for various common deployment scenarios and resource management tasks.
The examples catalog contains a number of sample manifests that aim to show the operator functionality in a practical way. Follow these instructions for getting started:
Download the examples catalog:
curl -sLO https://operator.mariadb.com/examples/manifests.tar.gz
mkdir -p examples
tar -xzf manifests.tar.gz -C examplesInstall the configuration shared by all the examples:
kubectl apply -f examples/configStart deploying examples:
kubectl apply -f examples/mariadb.yamlSome examples rely on external dependencies for specific tasks, make sure to install them when it applies:
prometheus-operator for metrics
cert-manager for TLS certificates
minio for S3 object storage
It is recommended to complement the examples with the API reference documentation to understand the full range of configuration options available.
If you are looking for production-grade examples, you can check the following manifests:
mariadb_replication_production.yamlandmaxscale_replication_production.yamlfor asynchronous replicationmariadb_galera_production.yamlandmaxscale_galera_production.yamlfor Galera
For TLS client certificate authentication, you can check the following manifests:
mariadb_replication_client_tls.yamlandmaxscale_replication_client_tls.yaml: a replicationMariaDBand itsMaxScalethat authenticate with TLS client certificates instead of passwords.mariadb_galera_client_tls.yaml: a GaleraMariaDBwith TLS client certificate authentication, including the SST settings it requires.user_client_certificate.yaml: aUserwith a dedicated TLS client certificate issued by the operator.migrate-to-client-auth/: step-by-step manifests to migrate a password-basedMariaDBto TLS client certificate authentication through a logical backup, as described in the migration guide.migrate-to-client-auth-replication/: manifests and a script to migrate with a shorter downtime, by replicating from the old instance until the cutover.
For restoring and backing up large datasets, check the following manifests, which use long timeouts and large volumes:
physicalbackup_pvc_large.yamlandphysicalbackup_volumesnapshot_large.yaml: physical backups to a PVC and to aVolumeSnapshot, with long timeouts.mariadb_galera_from_physicalbackup_large.yamlandmariadb_galera_from_volumesnapshot_large.yaml: Galera clusters bootstrapped from a physical backup and from aVolumeSnapshot.
This page is: Copyright © 2026 MariaDB. All rights reserved.
Last updated
Was this helpful?

