2026-02-14 Rolling Upgrade of CouchDB Nodes

2026-02-14 Rolling Upgrade of CouchDB Nodes

This changelog outlines the steps for a rolling upgrade of CouchDB nodes.

The upgrade must be performed in two stages:

  1. Upgrade from 3.3.x to 3.4.3

  2. Upgrade from 3.4.3 to 3.5.0

The rolling upgrade process remains the same for both stages. The only difference is updating the couchdb_version variable in environments//public.yml.

## About these release notes

If you run your own CommCare instance, these release notes are for you. As always, see [the changelog](https://commcare-cloud.readthedocs.io/en/latest/changelog/index.html) for the most up to date release notes and release note history.

These release notes are **not simply for your information**, they are **instructions for you to follow**.

Each change includes manual steps for you to follow to apply changes to your environment configuration or infrastructure that will allow you to be on the latest versions of commcare-cloud and commcare-hq.

Inside the instructions for applying the maintenance for each change, it will tell you whether there are any environments it may not be necessary for. When in doubt, apply the steps for every change.