couchbase-upgradelisted
Install: claude install-skill celticht32/Couchbase-Skills-for-Claude.ai
# Couchbase Upgrade
Planning and executing Couchbase Server version upgrades — upgrade paths, breaking changes, pre/post-upgrade steps, and 8.0-specific considerations.
Distinct from the rolling upgrade section in `couchbase-mcp` (which covers the MCP tool sequence for executing the upgrade). This skill covers the *planning* layer: what to check before you run those tools.
## When this skill applies
- "How do I upgrade from 7.x to 8.0?"
- "What changed in 8.0 that could break my cluster?"
- "What's the safe upgrade path?"
- "How do I verify the upgrade worked?"
- "What's the cluster compatibility version?"
- "Do I need EE for 8.0 defaults?"
## Supported upgrade paths
Couchbase supports upgrading one major version at a time:
| From | To | Supported |
|---|---|---|
| 7.0 / 7.1 / 7.2 / 7.6 | 8.0 | Yes — rolling upgrade |
| 6.x | 8.0 | No — must go through 7.x first |
| Community Edition | Enterprise Edition | Requires reinstall, not in-place upgrade |
**Always upgrade to the latest patch of your current version before upgrading to the next major version.** Bugs fixed in patch releases can affect the upgrade process itself.
## Pre-upgrade checklist
- [ ] Full cluster backup (cbbackupmgr or Capella managed backup)
- [ ] Verify current cluster is healthy: all nodes `active` + `healthy`, rebalance not in progress, XDCR caught up (`changes_left` ≈ 0)
- [ ] Review breaking changes for the target version (see below for 8.0)
- [ ] Test the upgrade on a staging cluster first
-