Versioning support by etcd

This document describes the versions supported by the etcd project.

Service versioning and supported versions

etcd versions are expressed as x.y.z, where x is the major version, y is the minor version, and z is the patch version, following Semantic Versioning terminology. New minor versions may add additional features to the API.

The etcd project maintains release branches for the current version and two minor releases, 3.5, 3.4 and 3.3 currently.

Applicable fixes, including security fixes, may be backported to those three release branches, depending on severity and feasibility. Patch releases are cut from those branches when required.

The project Maintainers own this decision.

You can check the running etcd cluster version with etcdctl:

etcdctl --endpoints= endpoint status

API versioning

The v3 API responses should not change after the 3.0.0 release but new features will be added over time.

Last modified January 5, 2022: Add etcd version support policy (bb7be3f)