{"id":212,"date":"2017-04-05T11:08:27","date_gmt":"2017-04-05T16:08:27","guid":{"rendered":"http:\/\/etapien.com\/guides\/?p=212"},"modified":"2020-08-24T14:22:20","modified_gmt":"2020-08-24T19:22:20","slug":"add-version-control-linux-etc-directory","status":"publish","type":"post","link":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/","title":{"rendered":"How to add version control for your Linux \/etc directory"},"content":{"rendered":"

When you think of the Linux \/etc directory, one thing comes to mind: configuration. There’s a good reason for that; most of your system configuration files are held in this crucial directory. In fact, nearly everything but your user configurations are housed within \/etc, so the importance of this directory cannot be overstated.<\/p>\n

That is why it’s important to monitor the changes that occur within this directory. Having the ability to handle version control of \/etc would make rolling back from a mistake to one of your data center Linux servers significantly easier. Unfortunately, unless your distribution makes use of the btrfs file system, there’s no real no version control built in. That’s why tools like etckeeper should be considered must haves.<\/p>\n

etckeeper is a set of tools that allows you to keep track of changes to \/etc using a Git, Mercurial, Bazaar, or Darcs repository like you would keep track of changes to a software project. The repository is housed on your local machine (in \/etc\/.git) and is automatically updated once daily.<\/p>\n

I will walk you through the installation and usage of etckeeper, using a git repository, on Ubuntu 16.04 Server.<\/p>\n

The first thing we must do is install the necessary components.
\nThis can be done with a single command:<\/p>\n

sudo apt-get install etckeeper git-core<\/p><\/blockquote>\n

Once this is handled, let’s tell git who we are with the commands:<\/p>\n

git config –global user.name “YOUR NAME”
\n?git config –global user.email YOUR EMAIL
\nWhere YOUR NAME is your actual name and YOUR EMAIL is your email address.<\/p>\n

Configure etckeeper
\nThere is only one configuration file for etckeeper, \/etc\/etckeeper\/etckeeper.conf. Open that file for editing and look at the top, where you’ll see the following:<\/p>\n

# The VCS to use.
\n?# VCS=”hg”
\n?VCS=”git”
\n?# VCS=”bzr”
\n?# VCS=”darcs”<\/p>\n

If the line VCS=”git” is commented out, remove the # character and comment out whatever line was uncommented by default (by adding a leading # to the line). That’s all the change you need to make. Save and close the configuration file.<\/p>\n

Initialize etckeeper
\nNow we must initialize etckeeper. Go back to the terminal window and issue the following command:<\/p>\n

sudo etckeeper init
\nYou should see the following report:<\/p>\n

Initialized empty Git repository in \/etc\/.git\/
\nNext we’ll run our initial commit with the command:<\/p>\n

sudo etckeeper commit “Initial commit.”
\nMake some changes
\nLet’s make some changes to the \/etc directory. We’ll do this by way of an upgrade. Run the following commands:<\/p>\n

sudo apt-get update
\n?sudo apt-get upgrade
\nOnce those commands complete, issue the command:<\/p>\n

sudo git log –summary -1
\nYou should see a listing of the changes that occurred to the \/etc directory (Figure A).<\/p>\n

Figure A
\n\"\"<\/a><\/p>\n

etckeeper is doing its thing.<\/p>\n

What if you make a change to a configuration file? Let’s change the ServerAdmin option in \/etc\/apache2\/sites-available\/000-default.conf file. Once we’ve made the change, save and close the file. Now we run the command sudo git status to see the change has been recorded (Figure B).<\/p>\n

Figure B
\n\"\"<\/a><\/p>\n

Note: You might notice, that I didn’t use the sudo command in the images. Because this is a test environment (running as a virtual machine), I first issue the command sudo -s to change to the root user. I don’t advise doing that on a production machine…stay out of root.<\/p>\n

Finally, we commit the change with the command:<\/p>\n

sudo etckeeper commit “Updated Apache configuration”
\nNow if we run sudo git log -1 -p the change will be visible in the log (Figure C).<\/p>\n

Figure C
\n\"\"<\/a><\/p>\n

Revision history at the ready
\nThat’s all there is to it. You now have the ability to retain a complete revision history of your \/etc directory. Anyone that has encountered issues with the \/etc directory will understand the importance of having such a system in place. It is important, however, that you run a commit anytime you make a change to \/etc. Yes, etckeeper will do a daily run, but if you want to make those changes easier to find, I highly recommend doing a manual etckeeper commit when you make a change to \/etc.<\/p>\n","protected":false},"excerpt":{"rendered":"

When you think of the Linux \/etc directory, one thing comes to mind: configuration. There’s a good reason for that; most of your system configuration files are held in this crucial directory. In fact, nearly everything but your user configurations are housed within \/etc, so the importance of this directory cannot be overstated. That is […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"yoast_head":"\nHow to add version control for your Linux \/etc directory - Tech Howtos<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to add version control for your Linux \/etc directory - Tech Howtos\" \/>\n<meta property=\"og:description\" content=\"When you think of the Linux \/etc directory, one thing comes to mind: configuration. There’s a good reason for that; most of your system configuration files are held in this crucial directory. In fact, nearly everything but your user configurations are housed within \/etc, so the importance of this directory cannot be overstated. That is […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/\" \/>\n<meta property=\"og:site_name\" content=\"Tech Howtos\" \/>\n<meta property=\"article:published_time\" content=\"2017-04-05T16:08:27+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-08-24T19:22:20+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg\" \/>\n<meta name=\"author\" content=\"Etapien\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Etapien\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/\",\"url\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/\",\"name\":\"How to add version control for your Linux \/etc directory - Tech Howtos\",\"isPartOf\":{\"@id\":\"https:\/\/etapien.com\/guides\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage\"},\"thumbnailUrl\":\"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg\",\"datePublished\":\"2017-04-05T16:08:27+00:00\",\"dateModified\":\"2020-08-24T19:22:20+00:00\",\"author\":{\"@id\":\"https:\/\/etapien.com\/guides\/#\/schema\/person\/c67f514649b78dbb5ef0c254a0521424\"},\"breadcrumb\":{\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage\",\"url\":\"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg\",\"contentUrl\":\"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/etapien.com\/guides\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to add version control for your Linux \/etc directory\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/etapien.com\/guides\/#website\",\"url\":\"https:\/\/etapien.com\/guides\/\",\"name\":\"Tech Howtos\",\"description\":\"Tech related useful howtos\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/etapien.com\/guides\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/etapien.com\/guides\/#\/schema\/person\/c67f514649b78dbb5ef0c254a0521424\",\"name\":\"Etapien\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/etapien.com\/guides\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/55021fd8fb4a829ad64ffab0a92d3b90?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/55021fd8fb4a829ad64ffab0a92d3b90?s=96&d=mm&r=g\",\"caption\":\"Etapien\"},\"url\":\"https:\/\/etapien.com\/guides\/author\/Etapien\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to add version control for your Linux \/etc directory - Tech Howtos","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/","og_locale":"en_US","og_type":"article","og_title":"How to add version control for your Linux \/etc directory - Tech Howtos","og_description":"When you think of the Linux \/etc directory, one thing comes to mind: configuration. There’s a good reason for that; most of your system configuration files are held in this crucial directory. In fact, nearly everything but your user configurations are housed within \/etc, so the importance of this directory cannot be overstated. That is […]","og_url":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/","og_site_name":"Tech Howtos","article_published_time":"2017-04-05T16:08:27+00:00","article_modified_time":"2020-08-24T19:22:20+00:00","og_image":[{"url":"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg"}],"author":"Etapien","twitter_misc":{"Written by":"Etapien","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/","url":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/","name":"How to add version control for your Linux \/etc directory - Tech Howtos","isPartOf":{"@id":"https:\/\/etapien.com\/guides\/#website"},"primaryImageOfPage":{"@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage"},"image":{"@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage"},"thumbnailUrl":"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg","datePublished":"2017-04-05T16:08:27+00:00","dateModified":"2020-08-24T19:22:20+00:00","author":{"@id":"https:\/\/etapien.com\/guides\/#\/schema\/person\/c67f514649b78dbb5ef0c254a0521424"},"breadcrumb":{"@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#primaryimage","url":"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg","contentUrl":"http:\/\/etapien.com\/guides\/wp-content\/uploads\/2017\/04\/etckeepera-300x244.jpg"},{"@type":"BreadcrumbList","@id":"https:\/\/etapien.com\/guides\/add-version-control-linux-etc-directory\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/etapien.com\/guides\/"},{"@type":"ListItem","position":2,"name":"How to add version control for your Linux \/etc directory"}]},{"@type":"WebSite","@id":"https:\/\/etapien.com\/guides\/#website","url":"https:\/\/etapien.com\/guides\/","name":"Tech Howtos","description":"Tech related useful howtos","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/etapien.com\/guides\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/etapien.com\/guides\/#\/schema\/person\/c67f514649b78dbb5ef0c254a0521424","name":"Etapien","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/etapien.com\/guides\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/55021fd8fb4a829ad64ffab0a92d3b90?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/55021fd8fb4a829ad64ffab0a92d3b90?s=96&d=mm&r=g","caption":"Etapien"},"url":"https:\/\/etapien.com\/guides\/author\/Etapien\/"}]}},"_links":{"self":[{"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/posts\/212"}],"collection":[{"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/comments?post=212"}],"version-history":[{"count":4,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/posts\/212\/revisions"}],"predecessor-version":[{"id":219,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/posts\/212\/revisions\/219"}],"wp:attachment":[{"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/media?parent=212"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/categories?post=212"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/etapien.com\/guides\/wp-json\/wp\/v2\/tags?post=212"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}