# NAME

Git::Server - Secure Git Server with more granular hooks capabilities than default git.

# DESCRIPTION

This is intented to be a drop-in replacement for any standard git server,
but provides more powerful server hooks and ACLs.

# SYNOPSIS

If you do not already have a git server or git repo ready, then make one:

    [admin@git-host ~]$ sudo useradd git
    [admin@git-host ~]$ sudo su - git -c 'git init --initial-branch=main --bare projectx'
    Initialized empty Git repository in /home/git/projectx/
    [admin@git-host ~]$

Put something like the following in its ~git/.ssh/authorized\_keys:

    command="git-server REMOTE_USER=user1" ssh-ed25519 AAAA_OAX+blah_pub__ user1@dev

Then the first authorized user to touch the repo should have full access:

    [user1@dev ~]$ git config --global user.name 'Mr Developer User1'
    [user1@dev ~]$ git config --global user.email user1@dev.com
    [user1@dev ~]$ git clone ssh://git@git-host/projectx
    [user1@dev ~]$ cd projectx
    [user1@dev projectx]$ echo 'Hello world' >> README
    [user1@dev projectx]$ git add README
    [user1@dev projectx]$ git commit -m 'First commit' README
    [user1@dev projectx]$ git push --set-upstream origin main
    [user1@dev projectx]$

See INSTALL.md to setup granular read and write access and/or
a simple push-notification instant deployment configuration.

# SEE ALSO

Similar purpose and functionality with [Git::Hooks](https://metacpan.org/pod/Git%3A%3AHooks) but more powerful and less dependencies.

# AUTHOR

Rob Brown <bbb@cpan.org>

# DEVELOPMENT

This module is maintained on github:

https://github.com/hookbot/git-server

Report feature requests or bugs here:

https://github.com/hookbot/git-server/issues

Pull requests welcome.

# COPYRIGHT AND LICENSE

Copyright 2015-2026 by Rob Brown <bbb@cpan.org>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
