Applying a git post-commit hook to all current and future repositories
GitHookGithooksGit Problem Overview
I've written a Git post-commit hook and it works correctly. However, I want to add this hook to apply to all current (and future) Git repositories I am working on. I tried adding the hook to my ~/.git/hooks/
directory instead of in the hooks directory in the project directory, however, this did not seem to work.
Is there a way to create global Git hooks that will apply to all repositories on my system (without having to copy them into each project directory)? If not, what would be the best solution going forward -- perhaps a git-init template?
Git Solutions
Solution 1 - Git
As of Git 1.7.1, you can set init.templatedir in your gitconfig to tell Git where to look for templates.
Set it like this:
git config --global init.templatedir '~/.git_template'
Afterward, new repositories you create or clone will use this directory for templates. Place the hooks you want in ~/.git_template/hooks
. Existing repositories can be reinitialized with the proper templates by running git init
in the same directory .git
is in.
For Git versions older than 1.7.1, running git init --template ~/.git_template
will work if you're like me and still want to manage your .git_template
directory along with the rest of your dot files. You can also use the $GIT_TEMPLATE_DIR
environment to tell git init
where your template directory is.
Solution 2 - Git
> I want to add this hook to apply to all current (and future) git repositories I am working on
With git 2.9+ (June 2016), all you would do is:
git config --global core.hooksPath /path/to/my/centralized/hooks
See "change default git hooks": this has been done to manage centralized hooks.
Solution 3 - Git
If you want them everywhere on your system (including users besides you), you can modify the contents of the installed template directory - those are in $PREFIX/share/git-core/templates/hooks
, where $PREFIX
is probably /usr/local
or /usr
.
If you want this to just be for you, then yes, the simplest thing would be the --template
option of git-init. You could easily keep a personal template directory which has symlinks back to the installed version of defaults you want to keep (individual hooks, the info directory...) and then your own content in hooks/post-commit
and anything else you want to customize.
Solution 4 - Git
A minimalist approach is to create a git_hooks/
directory in your repository to track the hooks that you write for that project, bring it to the attention of future users by mentioning it in a README
, and rely on them to do the right thing after they have cloned. I have cogitated on this for a while and chose an incremental approach. Down the road I might consider using a tool like git-hooks.