Katafygio records Kubernetes objects as YAML files in a Git repository. That gives operators a history of changes to resources such as Deployments and Services, and a way to recover selected declarations later. It is useful for configuration visibility or reconstruction, but it does not capture the application data stored in databases or volumes. The object selection also matters: accidentally recording Secrets can leave sensitive values permanently present in Git history.
Current guidance
The recovered marketplace URL is not the project’s primary documentation. The historical stable chart identifies bpineau/katafygio, whose README describes one-off dumps and continuous recording of Kubernetes objects as YAML in Git. The current upstream also documents its own chart repository, distinct from the retired central stable chart.
Choose the objects to include before enabling remote pushes. The upstream examples explicitly exclude Secrets, noisy events and controller-owned objects. Kubernetes Secrets encoded in YAML are not encrypted simply because their values use base64; accidental inclusion can persist sensitive data in Git history after the current file is deleted.
Decide whether this history is an audit record or a source for reconstruction, and avoid feeding generated controller state back into an independent GitOps reconciler. Test restoring a small application’s declarative resources into an isolated namespace and document the dependencies that must exist first. Back up persistent-volume data, external databases and credentials through appropriate separate mechanisms. A complete YAML dump cannot establish that an application’s data can be recovered or that its old API versions remain accepted.
Historical upstream link check · 2026-10-09
Automated availability verification was inconclusive on 2026-10-09 (connection or verification failure). Link availability does not certify the historical installation instructions or current security support.
Website availability is separate from project, chart and image support. Use the current guidance and primary sources on this page to assess the distribution.
Historical Kubedex content
Original publication: 2018-09-13T07:10:47+00:00. Preserved for context. Commands, versions, prices and results below reflect the original research.
Katafygio discovers Kubernetes objects (deployments, services, …), and continuously saves them as YAML files in a Git repository. This provides real-time, continuous backups, and keeps detailed changes history. This chart installs a Katafygio deployment on a Kubernetes cluster using the Helm package manager.
Prerequisites
Kubernetes 1.9+
Chart Details
You may filter out irrelevant objects using the excludeKind and excludeObject options, to keep your backups’ repository lean.
By default, the chart will dump (and version) the clusters content in /var/lib/katafygio/data (configurable with localDir). This can be useful as is, to keep a local changes history. To benefit from long term, out of cluster, and centrally reachable persistence, you may provide the address of a remote Git repository (with gitUrl), where all changes will be pushed.
Installation
You can find pre-built binaries in the releases page, ready to run on your desktop or in a cluster.
We also provide a docker image.
On MacOs, you can use the brew formula:
brew install bpineau/tap/katafygio
You can also deploy with the provided helm chart:
helm install –name kf-backups –namespace kube-system assets/helm-chart/katafygio/
If you want to build from sources, assuming you have go 1.10 and glide in the path, and GOPATH configured:
make deps
make build
The post Katafygio appeared first on kubedex.com.
Sources & further reading
Spotted something that needs another look?
Help improve this page →