HG-SSH(8) Mercurial Manual HG-SSH(8)

# [NAME](#NAME)

hg-ssh - restricted ssh login shell for Mercurial

# [SYNOPSIS](#SYNOPSIS)

**hg-ssh** repositories...

# [DESCRIPTION](#DESCRIPTION)

**hg-ssh** is a wrapper for ssh access to a limited set of mercurial repos.

To be used in ~/.ssh/authorized\_keys with the "command" option, see [sshd(8)](/man/os/mercurial/sshd.8): command="hg-ssh path/to/repo1 /path/to/repo2 ~/repo3 ~user/repo4" ssh-dss ... (probably together with these other useful options: no-port-forwarding,no-X11-forwarding,no-agent-forwarding)

This allows pull/push over ssh from/to the repositories given as arguments.

If all your repositories are subdirectories of a common directory, you can allow shorter paths with: command="cd path/to/my/repositories && hg-ssh repo1 subdir/repo2"

You can use pattern matching of your normal shell, e.g.: command="cd repos && hg-ssh user/thomas/* projects/{mercurial,foo}"

You can also add a --read-only flag to allow read-only access to a key, e.g.: command="hg-ssh --read-only repos/\*"

# [BUGS](#BUGS)

Probably lots, please post them to the mailing list (see Resources below) when you find them.

# [SEE ALSO](#SEE_ALSO)

[**hg**(1)](/man/os/mercurial/hg.1)

# [AUTHOR](#AUTHOR)

Written by Olivia Mackall <olivia@selenic.com>

# [RESOURCES](#RESOURCES)

Main Web Site: https://mercurial-scm.org/

Source code repository: https://www.mercurial-scm.org/repo/hg

Mailing list: https://www.mercurial-scm.org/mailman/listinfo/mercurial/

# [COPYING](#COPYING)

Copyright (C) 2005-2016 Olivia Mackall. Free use of this software is granted under the terms of the GNU General Public License version 2 or any later version.

# [AUTHOR](#AUTHOR~2)

Thomas Arendsen Hein <thomas@intevation.de>

Organization: Mercurial

---

Document: hg-ssh(8) from mercurial 7.2.4-r2 (Chainguard OS)
Source: https://www.mercurial-scm.org/release/mercurial-7.2.4.tar.gz