NAME

git-verify - Verify server configuration settings.

SYNOPSIS

git-verify [ <REMOTE> ] [ /path/to/server/repo.git ... ]

DESCRIPTION

Command-line utility to verify git server configuration for capabilities that could be used by git-server.

<REMOTE> can be any valid SCP-style Git URL, such as:

gituser@remote-git-server-host-name.com:my-repo.git

Or it can be a full ssh:// Git URL, such as:

ssh://gituser@remote-git-server-host-name.com/my-repo.git

Or if you don't care about any specific repo, then <REMOTE> can use simple ssh-style format, such as:

gituser@remote-git-server-host-name.com

If no user@ is provided, then ssh will use your current username.

If NO <REMOTE> is provided, then checks the current server where the command is run.

If no repo directories are specified, then the HOME directory is scanned for any directory that smells like a git repo.

TODO

* Only allow safe read-only operations appropriate for REMOTE_USER powers
* Validate scripts installation: git-server git-client git-deploy git-verify
* Validate core.hooksPath
* Validate ./hooks symlink for each repo if hooksPath not set
* Files and Directories chmod permissions
* Secured ~/.ssh/authorized_keys format, including "REMOTE_USER" settings
* Make sure ~/.ssh/authorized_keys has at least one ADMIN user
* ADMIN and ACL Management (if "ADMIN")
* Create / Remove repos (if "ADMIN")
* Validate or Configure "any-user"@server feature (if "ADMIN")

SUPPORTED

* Validate git-server installation.
* Verify AllowAgentForwarding setting for two-way sync feature.
* Verify AcceptEnv setting.
* Check ExposeAuthInfo functionality to be able to determine key info, if desired.
* List accessible repos specified or scanned.

AUTHOR

Rob Brown <bbb@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2025-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.