cbbackupmgr
docs.couchbase.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What cbbackupmgr is
cbbackupmgr is a self-hosted backup and restore client for Couchbase Server clusters. It creates incremental backups by transferring data added since the previous repository backup. Commands create, inspect, compact, merge, and remove backups, collect diagnostics, and restore data. Merging deduplicates content, which can reduce the resulting backup’s disk usage. For Couchbase Server 7.1.2 and later, native storage integrations support AWS S3, Google Storage, and Azure Blob Storage. Encrypted repositories use AES256GCM by default or AES256CBC, with external key managers including AWS KMS, GCP KMS, Azure Key Vault, and HashiCorp Vault Transit. Authentication supports credentials or a client certificate and private key. The utility runs on Linux, macOS, and Windows. Couchbase positions it as an Enterprise Edition tool and recommends Enterprise binaries for commercial production. Minimum hardware is four CPU cores and 8 GiB RAM; sixteen cores, 16 GiB RAM, and SSDs are recommended.
Who it suits
It suits teams operating self-hosted Couchbase Server clusters that need incremental backup and restore management. Enterprise Edition is recommended for commercial production systems.
Good to know, and what to watch
- Incremental backups are enabled by default
- Supports AWS, Google, and Azure storage
- Offers AES repository encryption
- Can deduplicate merged backups
- Runs on Linux, macOS, and Windows
- Point-in-time recovery is not provided
- Production passphrase encryption is unsupported
- Cluster commands are unsupported during major configuration changes
Plans
Every plan and priceCouchbase Server Enterprise subscription (includes cbbackupmgr)
Free plan
The verdict
cbbackupmgr provides lifecycle management for Couchbase backups with cloud storage, encryption, and deduplication options. Administrators must meet the hardware guidance and observe its operational restrictions.
What the maker publishes
- Authentication
- The utility can authenticate to a cluster with a username and password or with a client certificate and private key. source
- Backup encryption
- Encrypted repositories support AES256GCM by default or AES256CBC, with AWS KMS, GCP KMS, Azure Key Vault, and HashiCorp Vault Transit as external key managers. source
- Backup management
- The command suite can create repositories, inspect, compact, merge, and remove backups, collect diagnostic information, and restore data. source
- Cloud storage
- Native cloud integration supports AWS S3, Google Storage, and Azure Blob Storage for Couchbase Server 7.1.2 and later. source
- Deduplication
- Merging backups deduplicates data so the merged backup can use less disk space than the prior backups. source
- Hardware requirements
- The minimum hardware requirement is four CPU cores and 8 GiB RAM; the recommended hardware is sixteen CPU cores, 16 GiB RAM, and SSD disks. source
- Incremental backups
- All backups are incremental by default, transferring new data since the previous backup in the repository. source
- Intended use
- Couchbase describes cbbackupmgr as an Enterprise Edition tool and recommends Enterprise Edition binaries for commercial production systems. source
- Operational limitation
- Commands that connect to a cluster are unsupported during major cluster configuration changes, although they may run during a rebalance. source
- Passphrase limit
- The documentation says passphrase-based encryption is not supported in production and should be used only for development or testing. source
- Purpose
- cbbackupmgr is a high-performance backup and restore client for Couchbase Server clusters. source
- Support
- Couchbase directs urgent issues to its Support Team and bugs to its Jira Bug Tracker. source
Checked against the maker's pages on 8 Oct 2026.