KubeBlocks
BlogsKubeBlocks Cloud
⌘K
​

Overview

Introduction
Concepts
Kubernetes and Operator 101
Supported addons
About this manual

Try out KubeBlocks with Playground

Try out KubeBlocks on cloud
Try out KubeBlocks on laptop

Installation

Prerequisite for Local Env

Prerequisite for Local Env
Install kbcli
Install KubeBlocks
Install Addons
Uninstall KubeBlocks and kbcli

Upgrade KubeBlocks

Upgrade to v0.8
Upgrade to v0.9.0
Upgrade to v0.9.3
FAQ

Connect Database

Overview
Testing environment
Production environment

Maintenance

Scale

Horizontal Scale
Vertical Scale

Backup and Restore

Introduction

Backup

Configure BackupRepo
Configure BackupPolicy
Scheduled backup
On-demand backup

Restore

Restore from backup set
PITR

In Place Update

Overview on in-place update
Enable in-place update

Resource Scheduling

Configure pod affinity for database clusters

Cross K8s Deployment

Deploy a Cluster across Multiple Kubernetes Clusters by KubeBlocks

Instance Template

Introduction of instance template
Apply instance template

Observability

Monitor database
Configure alert

User Management

Manage user accounts

Handle an Exception

Handle an exception
Full disk lock

Developer

Developer guides
Terminology

Add an add-on to KubeBlocks

Add-ons of KubeBlocks
Add an add-on
Backup and restore
Parameter template
Parameter configuration
Monitoring
Multi-component configuration
Environment variables and placeholders

External Component

Reference external component

API Reference

Cluster
Backup
Add-On
  1. Relational Databases
    1. MySQL and its variants
    2. Postgresql and its variants
  2. NoSQL
  3. OLAP Systems
  4. Distributed SQL Databases
  5. Message Queues
  6. Vector Databases
  7. Time Series Databases
  8. Graph Databases
  9. Storage System

Supported Addons

KubeBlocks uses Addons to extend support for various database engines. And there are currently over 30 Addons available in the KubeBlocks repository, which can be further categorized as follows sections.

For installing and enabling Addons, refer to Addon installation tutorial.

Relational Databases

MySQL and PostgreSQL are the two most popular open-source relational databases in the world, and they have branches/variants.

MySQL and its variants

Addon List

AddonsDescription
mysqlThis addon uses the community edition MySQL image officially released by Oracle.
apecloud-mysqlApeCloud MySQL is a free, fully compatible drop-in replacement for MySQL Community Edition, offering enhanced high availability through a RAFT protocol replication plugin. The image is provided by ApeCloud. Additionally, ApeCloud MySQL includes an open-source proxy called WeScale, which provides features such as read-write splitting and connection pooling.
mariadbMariaDB is a high performance open source relational database management system that is widely used for web and application servers.

Supported Features

NOTE

The versions listed below may not be up-to-date, and some supported versions might be missing. For the latest addon versions, please refer to the KubeBlocks addon GitHub repo.

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
mysql

5.7.44

8.0.33

8.4.2

✔️✔️✔️✔️✔️✔️✔️✔️✔️N/A✔️✔️✔️
apecloud-mysql

8.0.30

✔️✔️✔️✔️✔️✔️✔️✔️✔️N/A✔️✔️✔️
mariadb10.6.15✔️N/A✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

Postgresql and its variants

Addon List

AddonsDescription
postgresqlThis addon provides PostgreSQL services using the Spilo image with Patroni for high availability (HA).
apecloud-postgresqlApeCloud PostgreSQL is a free, fully compatible drop-in replacement for PostgreSQL, offering enhanced high availability through a RAFT protocol replication plugin.
official-postgresqlThis addon includes vanilla PostgreSQL, the official release from the PostgreSQL community, without any modifications, optimizations, or packaging from third-party vendors.
oriolebdOrioleDB is a new storage engine for PostgreSQL, bringing a modern approach to database capacity, capabilities and performance to the world's most-loved database platform.
neonNeon is Serverless Postgres.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
postgresql

12.14.0

12.14.1

12.15.0

14.7.2

14.8.0

15.7.0

✔️✔️✔️✔️✔️✔️✔️✔️✔️✔️✔️✔️✔️
apecloud-postgresql14.11.0✔️✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/A
official-postgresql14.7✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
orioledb14.7.2-beta1✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
neon

neon-broker-1.0.0

neon-compute-1.0.0

neon-pageserver-1.0.0

neon-safekeeper-1.0.0

✔️N/AN/AN/AN/AN/AN/AN/AN/AN/AN/AN/AN/A

NoSQL

Addon List

AddonsDescription
mongodbMongoDB is a document-oriented NoSQL database used for high volume data storage.
redisRedis is a fast, open source, in-memory, key-value data store.
etcdetcd is a strongly consistent, distributed key-value store that provides a reliable way to store data that needs to be accessed by a distributed system or cluster of machines.
zookeeperApache ZooKeeper is a centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
mongodb

4.0.28

4.2.24

4.4.29

5.0.28

6.0.16

7.0.12

✔️✔️✔️✔️✔️✔️✔️✔️✔️N/AN/A✔️✔️
redis

redis-7.0.6

redis-7.2.4

redis-cluster-7.0.6

redis-cluster-7.2.4

redis-sentinel-7.0.6

redis-sentinel-7.2.4

redis-twemproxy-0.5.0

✔️✔️✔️✔️✔️✔️✔️✔️✔️N/A✔️✔️N/A
etcd

3.5.15

3.5.6

✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
zookeeper

3.4.14

3.6.4

3.7.2

3.8.4

3.9.2

✔️✔️✔️✔️✔️N/AN/A✔️✔️N/AN/AN/AN/A

OLAP Systems

Addon List

AddonsDescription
elasticsearchElasticsearch is a distributed, RESTful search engine optimized for speed and relevance on production-scale workloads.
starrocks-ceStarRocks is a next-gen, high-performance analytical data warehouse that enables real-time, multi-dimensional, and highly concurrent data analysis.
clickhouseClickHouse is a column-oriented database that enables its users to generate powerful analytics, using SQL queries, in real-time.
opensearchOpen source distributed and RESTful search engine.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
elasticsearch

7.10.1

7.7.1

7.8.1

8.1.3

8.8.2

8.8.2
✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
starrocks-ce

starrocks-ce-be-3.2.2

starrocks-ce-be-3.3.0

starrocks-ce-fe-3.2.2

starrocks-ce-fe-3.3.0

✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
clickhouse22.9.4✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
opensearch2.7.0✔️N/A✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

Distributed SQL Databases

Addon List

AddonsDescription
tidbTiDB is a MySQL-compatible distributed database, with the SQL layer developed in Go, the storage layer based on RocksDB, and the transaction model using Percolator. Provided by PingCap.
oceanbase-ceOceanBase Community Edition is a MySQL-compatible distributed database developed in C++.
polardb-xPolarDB-X Community Edition is a MySQL-compatible distributed database that supports horizontal scaling based on MySQL. Provided by Alibaba Cloud, it is open-source.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
tidb

6.5.10

7.1.5

7.5.2

tidb-pd-6.5.10

tidb-pd-7.1.5

tidb-pd-7.5.2

tikv-6.5.10

tikv-7.1.5

tikv-7.5.2

✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
oceanbase4.3.0N/A✔️✔️N/AN/AN/AN/AN/AN/AN/AN/AN/A
polardb-x2.3✔️✔️N/A✔️N/AN/AN/AN/AN/AN/AN/AN/AN/A

Message Queues

Addon List

AddonsDescription
kafkaApache Kafka is an open-source distributed event streaming platform used by thousands of companies for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications.
rabbitmqRabbitMQ is a reliable and mature messaging and streaming broker.
pulsarApache Pulsar is an open-source, distributed messaging and streaming platform.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
kafka

kafka-broker-3.3.2

kafka-combine-3.3.2

kafka-controller-3.3.2

kafka-exporter-1.6.0

✔️✔️✔️✔️✔️N/AN/AN/A✔️N/AN/AN/AN/A
rabbitmq

3.13.2

3.12.14

3.11.28

3.10.25

3.9.29

3.8.14

✔️✔️✔️✔️✔️✔️N/AN/AN/AN/AManaged by the RabitMQ Management system.✔️✔️
pulsar

pulsar-bkrecovery-2.11.2

pulsar-bkrecovery-3.0.2

pulsar-bookkeeper-2.11.2

pulsar-bookkeeper-3.0.2

pulsar-broker-2.11.2

pulsar-broker-3.0.2

pulsar-proxy-2.11.2

pulsar-proxy-3.0.2

pulsar-zookeeper-2.11.2

pulsar-zookeeper-3.0.2

✔️✔️✔️✔️✔️N/AN/AN/A✔️N/AN/AN/AN/A

Vector Databases

Addon List

AddonsDescription
qdrantQdrant is a vector database & vector similarity search engine.
weaviateWeaviate is an open-source vector database.
milvusMilvus is a flexible, reliable, & blazing-fast cloud-native, open-source vector database.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
qdrant

1.10.0

1.5.0

1.7.3

1.8.1

1.8.4

✔️✔️✔️✔️✔️N/A✔️N/AN/AN/AN/AN/AN/A
weaviate1.23.1✔️✔️✔️✔️✔️N/AN/AN/A✔️N/AN/AN/AN/A
milvus2.3.2✔️N/A✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

Time Series Databases

Addon List

AddonsDescription
influxdbInfluxDB enables real-time analytics by serving as a purpose-built database that optimizes processing and scaling for large time series data workloads.
victoria-metricsVictoriaMetrics is a fast, cost-effective and scalable monitoring solution and time series database.
greptimedbGreptimeDB is an open-source time-series database with a special focus on scalability, analytical capabilities and efficiency.
tdengineTDengine™ is an industrial data platform purpose-built for the Industrial IoT, combining a time series database with essential features like stream processing, data subscription, and caching.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
influxdb2.7.4✔️N/A✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
victoria-metrics1.0.0
greptimedb0.3.2✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A
tdengine3.0.5✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

Graph Databases

Addon List

AddonsDescription
nebulaNebulaGraph is an open source graph database that can store and process graphs with trillions of edges and vertices.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
nebula3.5.0✔️✔️✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

Storage System

Addon List

AddonsDescription
minioMinIO is an object storage solution that provides an Amazon Web Services S3-compatible API and supports all core S3 features.

Supported Features

Addon (v0.9.0)Supported VersionsVscaleHscaleVolumeexpandStop/StartRestartExposeBackup/RestoreLogsConfigUpgrade (DB engine version)AccountFailoverSwitchover
minioRELEASE.2024-06-29T01-20-47Z✔️N/A✔️✔️✔️N/AN/AN/AN/AN/AN/AN/AN/A

© 2025 ApeCloud PTE. Ltd.