summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/version/git.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/server/plugins/version/git.txt')
-rw-r--r--doc/server/plugins/version/git.txt20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/server/plugins/version/git.txt b/doc/server/plugins/version/git.txt
new file mode 100644
index 000000000..0bbef7288
--- /dev/null
+++ b/doc/server/plugins/version/git.txt
@@ -0,0 +1,20 @@
+.. -*- mode: rst -*-
+
+.. _server-plugins-version-git:
+
+===
+Git
+===
+
+Why use the Git plugin
+======================
+
+The Git plugin is useful if you would like to track changes to your bcfg2 repository using a `Git <http://git-scm.com/>`_ backend. Currently, It enables you to get revision information out of your repository for reporting purposes. Future plans are to commit changes to the repo which are made by the server.
+
+How to enable the Git plugin
+============================
+
+The Git plugin uses `Dulwich <http://samba.org/~jelmer/dulwich/>`_ to interface with git repositories. Therefore, you will need to install Dulwich on the bcfg2 server first. Once installed, simply add Git to your plugins line in /etc/bcfg2.conf::
+
+ [server]
+ plugins = Base,Bundler,Cfg,...,Git