Branch Management

You are viewing documentation for etcd version: v2

etcd v2 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest release, v3.4.0, or the current documentation.


  • New development occurs on the master branch.
  • Master branch should always have a green build!
  • Backwards-compatible bug fixes should target the master branch and subsequently be ported to stable branches.
  • Once the master branch is ready for release, it will be tagged and become the new stable branch.

The etcd team has adopted a rolling release model and supports one stable version of etcd.

Master branch

The master branch is our development branch. All new features land here first.

If you want to try new features, pull master and play with it. Note that master may not be stable because new features may introduce bugs.

Before the release of the next stable version, feature PRs will be frozen. We will focus on the testing, bug-fix and documentation for one to two weeks.

Stable branches

All branches with prefix release- are considered stable branches.

After every minor release (, we will have a new stable branch for that release. We will keep fixing the backwards-compatible bugs for the latest stable release, but not previous releases. The patch release, incorporating any bug fixes, will be once every two weeks, given any patches.

Branch Management