etckeeper #0

Supports: bionic xenial
Add to new model


etckeeper is a collection of tools to let /etc be stored in a git, mercurial, bazaar or darcs repository. This lets you use git to review or revert changes that were made to /etc. Or even push the repository elsewhere for backups or cherry-picking configuration changes. It hooks into package managers like apt to automatically commit changes made to /etc during package upgrades. It tracks file metadata that git does not normally support, but that is important for /etc, such as the permissions of /etc/shadow.

etckeeper charm


This charm will deploy and configure etckeeper.

etckeeper is a tool which will maintain a VCS repository for the contents of /etc on a live system.

The goal is to ensure that all changes to system configuration are committed to the repository, allowing historical snapshots to be taken so tha changes in configuration can be tracked.

Optionally, if a remote is specified, this can be useful for backing up the contents of /etc on deployed units for auditing and backup purposes.

etckeeper integrates with several system hooks, including package installation, to make sure changes are captured in a timely manner. Optionally, a daily timer can be enabled to take a snapshot once per day, to capture any changes made manually.


This charm supports the following options: - vcs: Specify the VCS type. Defaults to git. - vcs-remote: When enabled, enables pushing of changes to a remote repository at commit-time. - daily: enables a daily commit of any changes to /etc. If a remote is enabled, will also push changes to the remote repoistory.


To build: make release

To test (lint, unit and functional): make test


This charm is written and maintained by "James Hebden" of Canonical.




(boolean) Enable a timer to commit (and push) changes once per day
(string) The VCS to use when committing and pushing changes
(string) Remote repo to push changes to - Will not push if empty