Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

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

Couchbase 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.