gardener/etcd-backup-restore

Collection of components to backup and restore the etcd of a Kubernetes cluster.

Go

334

703 commits

updated Oct 14, 2026

See the code

README

Etcd-Backup-Restore

REUSE status Go Report Card GoDoc

Etcd-backup-restore is a collection of components for backing up and restoring an etcd cluster. It also validates the etcd's data directory and auto-triggers restoration when needed.

etcd-backup-restore currently provides the following capabilities (the list is not comprehensive):

  • Backups: etcd database snapshots (a.k.a full snapshots) and incremental snapshots are taken regularly, compressed and stored in the configured object storage provider.
  • Data directory validation: It validates the etcd data directory before starting any etcd member.
  • Restoration: In case of a database corruption for a single-member cluster it restores from latest set of snapshots (full & delta).
  • Zero-downtime member recovery: Replaces a failed member in a multi-member etcd cluster without any downtime.
  • Automated maintenance: Auto runs etcd's database maintenance operations such as defragmentation on a configured schedule.
  • Secondary backups: In addition to primary backup storage, it uploads backups to a secondary object store, if configured, for higher backup resilience.
  • Metrics: Exposes metrics to monitor the health and status of etcd-backup-restore operations.

Getting Started

Please check the Getting started guide for instructions on installation and basic usage. For detailed documentation, head over to the docs.

Contributions

If you wish to contribute then please see our contributor guide.

Feedback and Support

We always look forward to active community engagement. Please report bugs or suggestions on how we can enhance etcd-backup-restore on GitHub Issues.

License

This project is maintained under Apache-2.0 license.

aws
azure
backup
backup-restore
etcd
etcd-backup-restore
gcp
kubernetes
openstack-swift
restore

gardener/etcd-backup-restore

Collection of components to backup and restore the etcd of a Kubernetes cluster.

Go

334

703 commits

updated Oct 14, 2026

See the code

README

Etcd-Backup-Restore

REUSE status Go Report Card GoDoc

Etcd-backup-restore is a collection of components for backing up and restoring an etcd cluster. It also validates the etcd's data directory and auto-triggers restoration when needed.

etcd-backup-restore currently provides the following capabilities (the list is not comprehensive):

  • Backups: etcd database snapshots (a.k.a full snapshots) and incremental snapshots are taken regularly, compressed and stored in the configured object storage provider.
  • Data directory validation: It validates the etcd data directory before starting any etcd member.
  • Restoration: In case of a database corruption for a single-member cluster it restores from latest set of snapshots (full & delta).
  • Zero-downtime member recovery: Replaces a failed member in a multi-member etcd cluster without any downtime.
  • Automated maintenance: Auto runs etcd's database maintenance operations such as defragmentation on a configured schedule.
  • Secondary backups: In addition to primary backup storage, it uploads backups to a secondary object store, if configured, for higher backup resilience.
  • Metrics: Exposes metrics to monitor the health and status of etcd-backup-restore operations.

Getting Started

Please check the Getting started guide for instructions on installation and basic usage. For detailed documentation, head over to the docs.

Contributions

If you wish to contribute then please see our contributor guide.

Feedback and Support

We always look forward to active community engagement. Please report bugs or suggestions on how we can enhance etcd-backup-restore on GitHub Issues.

License

This project is maintained under Apache-2.0 license.

aws
azure
backup
backup-restore
etcd
etcd-backup-restore
gcp
kubernetes
openstack-swift
restore

Project health

Overall

6.0/10

Maintained

10/10

Code review

8/10
OpenSSF Scorecard

Latest release

v0.45.1 · Sep 30, 2026

Releases this year

11

Significant stargazers

my-git9

42 followers · starred Feb 2024

Yecheng Fu

575 followers · starred Apr 2020

Marques Johansson

202 followers · starred Dec 2018

Yisaer

356 followers · starred Apr 2020