Skip to content
Back to search

mariadb-operator

🦭 Run and operate MariaDB in a cloud native way

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mariadb-operator/mariadb-operator with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mariadb-operator/mariadb-operator'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mariadb-operator--mariadb-operator/badge.svg)](/listings/mariadb-operator--mariadb-operator)

HTML

<a href="/listings/mariadb-operator--mariadb-operator"><img src="/api/listings/mariadb-operator--mariadb-operator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Helm charts are available as [OCI images on GitHub Container Registry](./docs/helm.md#oci-based-installation):

helm install mariadb-operator-crds oci://ghcr.io/mariadb-operator/charts/mariadb-operator-crds
helm install mariadb-operator oci://ghcr.io/mariadb-operator/charts/mariadb-operator
helm install mariadb-cluster oci://ghcr.io/mariadb-operator/charts/mariadb-cluster

Refer to the [helm documentation](./docs/helm.md) for further detail.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 143 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center" width="100%">
  2. <img src="https://mariadb-operator.github.io/mariadb-operator/assets/mariadb_centered_whitebg.svg" alt="mariadb" width="500"/>
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/ci.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  6. <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/release.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/release.yml/badge.svg" alt="Release"></a>
  7. <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm.yml/badge.svg" alt="Helm"></a>
  8. <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm-release.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm-release.yml/badge.svg" alt="Helm release"></a>
  9. </p>
  10. <p align="center">
  11. <a href="https://github.com/mariadb-operator/mariadb-operator"><img alt="GitHub" src="https://img.shields.io/github/stars/mariadb-operator/mariadb-operator"></a>
  12. <a href="https://github.com/mariadb-operator/mariadb-operator/tree/main/docs/README.md"><img src="https://img.shields.io/badge/docs-latest-blue?logo=readthedocs&logoColor=white" alt="Docs"></a>
  13. <a href="https://github.com/mariadb-operator/mariadb-operator/pkgs/container/mariadb-operator"><img src="https://img.shields.io/badge/ghcr.io-mariadb--operator-blue?logo=docker&logoColor=white" alt="Container image"></a>
  14. <a href="https://r.mariadb.com/join-community-slack"><img alt="Slack" src="https://img.shields.io/badge/slack-join_chat-blue?logo=Slack&label=slack&style=flat"></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://pkg.go.dev/github.com/mariadb-operator/mariadb-operator/v26"><img src="https://pkg.go.dev/badge/github.com/mariadb-operator/mariadb-operator.svg" alt="Go Reference"></a>
  18. <a href="https://artifacthub.io/packages/helm/mariadb-operator/mariadb-operator"><img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/mariadb-operator" alt="Artifact Hub"></a>
  19. <a href="https://operatorhub.io/operator/mariadb-operator"><img src="https://img.shields.io/badge/Operator%20Hub-mariadb--operator-red" alt="Operator Hub"></a>
  20. </p>
  21. # 🦭 mariadb-operator
  22. Run and operate MariaDB in a cloud native way. Declaratively manage your MariaDB using Kubernetes [CRDs](https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/) rather than imperative commands.
  23. - Easily provision [standalone MariaDB servers](./docs/standalone.md) in Kubernetes.
  24. - Multiple [highly available](./docs/high_availability.md) topologies supported:
  25. - [Asynchronous replication](./docs/replication.md)
  26. - [Synchronous multi-master via Galera](./docs/galera.md)
  27. - __[Multi-cluster](./docs/multi-cluster.md)✨__: cross-cluster replication for multi-region deployments, disaster recovery, and blue-green upgrades.
  28. - [MaxScale](./docs/maxscale.md) as database proxy to load balance requests and perform failover/switchover operations
  29. - Flexible [storage](./docs/storage.md) configuration. [Volume expansion](./docs/storage.md#volume-resize).
  30. - [Physical backups](./docs/physical_backup.md) based on [mariadb-backup](https://mariadb.com/docs/server/server-usage/backup-and-restore/mariadb-backup/full-backup-and-restore-with-mariadb-backup) and [Kubernetes VolumeSnapshots](https://kubernetes.io/docs/concepts/storage/volume-snapshots/).
  31. - [Logical backups](./docs/logical_backup.md) based on [mariadb-dump](https://mariadb.com/docs/server/clients-and-utilities/backup-restore-and-import-clients/mariadb-dump).
  32. - Multiple [backup storage types](./docs/physical_backup.md#storage-types): S3 compatible, Azure Blob Storage, PVCs, Kubernetes volumes and `VolumeSnapshots`.
  33. - Flexible backup configuration: [scheduling](./docs/physical_backup.md#scheduling), [compression](./docs/physical_backup.md#compression), [encryption](./docs/physical_backup.md#server-side-encryption-with-customer-provided-keys-sse-c), [retention policy](./docs/physical_backup.md#retention-policy), [target policy](./docs/physical_backup.md#target-policy), [timeout](./docs/physical_backup.md#timeout), [staging area](./docs/physical_backup.md#staging-area)...
  34. - [Target recovery time](./docs/physical_backup.md#target-recovery-time): restore the closest available backup to the specified time.
  35. - [Bootstrap new instances](./docs/physical_backup.md#restoration) from: Physical backups, logical backups, S3, Azure Blob Storage, PVCs, `VolumeSnapshots`...
  36. - [Point-In-Time-Recovery](./docs/pitr.md): Archive binary logs to enable point-in-time restoration and significantly reduce RPO.
  37. - [Cluster-aware rolling update](./docs/updates.md#replicasfirstprimarylast): roll out replica Pods one by one, wait for each of them to become ready, and then proceed with the primary Pod, using `ReplicasFirstPrimaryLast`.
  38. - Zero-downtime blue-green updates: leverage the [multi-cluster topology](./docs/multi-cluster.md) to maintain two identical cluster topologies, upgrade one in the background, and switch between them without downtime.
  39. - Manual [update strategies](./docs/updates.md#update-strategies): `OnDelete` and `Never`.
  40. - Automated [data-plane updates](./docs/updates.md#auto-update-data-plane).
  41. - [my.cnf change detection](./docs/configuration.md#mycnf). Automatically trigger [updates](./docs/updates.md) when my.cnf changes.
  42. - [Suspend](./docs/suspend.md) operator reconciliation for maintenance operations.
  43. - [Maintenance mode](./docs/maintenance.md) for safe operational windows: cordon, drain connections, and read-only modes.
  44. - Issue, configure and rotate [TLS certificates](./docs/tls.md) and CAs.
  45. - Automated [root password rotation](./docs/security.md#root-password-rotation) by updating the referenced `Secret`.
  46. - Native integration with [cert-manager](https://github.com/cert-manager/cert-manager). Automatically create `Certificate` resources.
  47. - [Prometheus metrics](./docs/metrics.md) via [mysqld-exporter](https://github.com/prometheus/mysqld_exporter) and maxscale-exporter.
  48. - Native integration with [prometheus-operator](https://github.com/prometheus-operator/prometheus-operator). Automatically create `ServiceMonitor` resources.
  49. - Declaratively manage [SQL resources](./docs/sql_resources.md): [users](./examples/manifests/user.yaml), [grants](./examples/manifests/grant.yaml) and logical [databases](./examples/manifests/database.yaml).
  50. - Declaratively manage resources in [external MariaDB instances](./docs/external_mariadb.md).
  51. - Configure [connections](./examples/manifests/connection.yaml) for your applications.
  52. - Orchestrate and schedule [sql scripts](./examples/manifests/sqljobs).
  53. - Validation webhooks to provide CRD immutability.
  54. - Additional printer columns to report the current CRD status.
  55. - CRDs designed according to the Kubernetes [API conventions](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md).
  56. - Install it using [helm](./docs/helm.md), [OLM](https://operatorhub.io/operator/mariadb-operator) or [static manifests](./deploy/manifests).
  57. - Multiple [deployment modes](./docs/helm.md#deployment-modes): cluster-wide and single namespace.
  58. - Helm charts published as [OCI artifacts](./docs/helm.md#oci-based-installation).
  59. - Helm chart to deploy [MariaDB clusters](./docs/helm.md#mariadb-cluster-helm-chart) and its associated CRs.
  60. - Multi-arch distroless [image](https://github.com/orgs/mariadb-operator/packages/container/package/mariadb-operator).
  61. - [GitOps](#gitops) friendly.
  62. ## Documentation
  63. For the user manual, getting started, guides, and API reference, please see the [**📚docs directory**](./docs/README.md).
  64. ## Examples catalog
  65. For example Custom Resources (CRs) demonstrating how to use the operator, refer to the [**🛠️examples directory**](./examples/manifests/).
  66. ## Helm installation
  67. Helm charts are available as [OCI images on GitHub Container Registry](./docs/helm.md#oci-based-installation):
  68. ```bash
  69. helm install mariadb-operator-crds oci://ghcr.io/mariadb-operator/charts/mariadb-operator-crds
  70. helm install mariadb-operator oci://ghcr.io/mariadb-operator/charts/mariadb-operator
  71. helm install mariadb-cluster oci://ghcr.io/mariadb-operator/charts/mariadb-cluster
  72. ```
  73. Refer to the [helm documentation](./docs/helm.md) for further detail.
  74. ## Upgrading from older releases
  75. When upgrading from an older version of the operator, it’s important to understand how both operator and operand resources are affected. Ensure you read both the [updates section of the helm docs](https://github.com/mariadb-operator/mariadb-operator/blob/main/docs/helm.md#updates), and the [release notes](https://github.com/mariadb-operator/mariadb-operator/releases) for any additional version-specific steps that may be required. Do not attempt to skip intermediate version upgrades. Upgrade progressively through each version to the next.
  76. ## Openshift installation
  77. The Openshift installation is managed separately in the [mariadb-operator-helm](https://github.com/mariadb-operator/mariadb-operator-helm) repository, which contains a [helm based operator](https://sdk.operatorframework.io/docs/building-operators/helm/) that allows you to install `mariadb-operator` via [OLM](https://olm.operatorframework.io/docs/).
  78. ## Image compatibility
  79. `mariadb-operator` is only compatible with official MariaDB images. Refer to the [images documentation](./docs/docker.md) for further detail.
  80. ## MariaDB compatibility
  81. - MariaDB Community >= 10.6
  82. ## MaxScale compatibility
  83. - MaxScale >= 23.08
  84. ## Kubernetes compatibility
  85. - Kubernetes >= 1.31
  86. - OpenShift >= 4.18
  87. ## Migrate your MariaDB instance to Kubernetes
  88. This [migration guide](./docs/logical_backup.md#migrating-an-external-mariadb-to-a-mariadb-running-in-kubernetes) will streamline your onboarding process and assist you in migrating your data into a `MariaDB` instance running on Kubernetes.
  89. ## Roadmap
  90. We are actively working on the following features, which will be released in upcoming versions. Stay tuned!
  91. - [x] ~~[Point In Time Recovery (PITR)](https://github.com/mariadb-operator/mariadb-operator/issues/507)~~
  92. - [x] ~~[Multi-cluster topology](https://github.com/mariadb-operator/mariadb-operator/issues/1543)~~
  93. ## Adopters
  94. Please create a PR and add your company or project to our [ADOPTERS.md file](./ADOPTERS.md) if you are using our project!
  95. ## Contributing
  96. We welcome and encourage contributions to this project! Please check our [contributing](./CONTRIBUTING.md) and [development](./docs/development.md) guides. PRs welcome!
  97. ## Community
  98. - [MariaDB Operator: HA MySQL the Modern Way](https://medium.com/@pascal.toepke/mariadb-operator-ha-mysql-the-modern-way-70ccf85c2e46) - Pascal Töpke, July 2026
  99. - [Run and Operate MariaDB in a Cloud Native Way Using the MariaDB Operator](https://www.youtube.com/watch?v=UwNFpYRETf4) - [@mmontes11](https://github.com/mmontes11) @ BuildDevCon: DB Mastery Series, June 2026
  100. - [Running MariaDB Server on Kubernetes](https://www.youtube.com/watch?v=R1oD1uMqyv8) - Frédéric Descamps @ BuildDevCon: DB Mastery Series, June 2026
  101. - [Why MariaDB Operator 25.10 Is a Big Deal for Stateful Workloads on Kubernetes](https://www.mrplanb.com/blog/mariadb-operator-25-10-stateful-kubernetes) - Mr.PlanB blog, October 2025
  102. - [The MariaDB Operator for Kubernetes](https://kubeadm.org/mariadb-operator-kubernetes/) - kubeadm.org
  103. - [Can You Run a MariaDB Cluster on a $150 Kubernetes Lab? I Gave It a Shot](https://dzone.com/articles/mariadb-cluster-on-kubernetes-lab-test) - Alejandro Duarte @ DZone, May 2025
  104. - [We Tested and Compared 6 Database Operators. The Results are In!](https://www.youtube.com/watch?v=l33pcnQ4cUQ&t=17m25s) - KubeCon EU, March 2024
  105. - [Get Started with MariaDB in Kubernetes and mariadb-operator](https://mariadb.com/resources/blog/get-started-with-mariadb-in-kubernetes-and-mariadb-operator/) - MariaDB Corporation blog, February 2024
  106. - [Run and operate MariaDB in Kubernetes with mariadb-operator](https://mariadb.org/mariadb-in-kubernetes-with-mariadb-operator/) - MariaDB Foundation blog, July 2023
  107. - [L'enfer des DB SQL sur Kubernetes face à la promesse des opérateurs](https://www.youtube.com/watch?v=d_ka7PlWo1I&t=2415s&ab_channel=KCDFrance) - KCD France, March 2023
  108. Join us on Slack: **[MariaDB Community Slack](https://r.mariadb.com/join-community-slack)**.
  109. ## Enterprise
  110. For enterprise users, see the __[MariaDB Enterprise Operator](https://mariadb.com/products/enterprise/kubernetes-operator/)__, a commercially supported Kubernetes operator from MariaDB with additional enterprise-grade features.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.