1HG-SSH(8)                      Mercurial Manual                      HG-SSH(8)
2
3
4

NAME

6       hg-ssh - restricted ssh login shell for Mercurial
7

SYNOPSIS

9       hg-ssh repositories...
10

DESCRIPTION

12       hg-ssh is a wrapper for ssh access to a limited set of mercurial repos.
13
14       To  be  used  in  ~/.ssh/authorized_keys with the "command" option, see
15       sshd(8):   command="hg-ssh   path/to/repo1    /path/to/repo2    ~/repo3
16       ~user/repo4"  ssh-dss  ...   (probably together with these other useful
17       options: no-port-forwarding,no-X11-forwarding,no-agent-forwarding)
18
19       This allows pull/push over ssh from/to the repositories given as  argu‐
20       ments.
21
22       If  all your repositories are subdirectories of a common directory, you
23       can allow shorter paths with:  command="cd  path/to/my/repositories  &&
24       hg-ssh repo1 subdir/repo2"
25
26       You  can  use  pattern matching of your normal shell, e.g.: command="cd
27       repos && hg-ssh user/thomas/* projects/{mercurial,foo}"
28
29       You can also add a --read-only flag to allow read-only access to a key,
30       e.g.: command="hg-ssh --read-only repos/*"
31

BUGS

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

SEE ALSO

37       hg(1)
38

AUTHOR

40       Written by Matt Mackall <mpm@selenic.com>
41

RESOURCES

43       Main Web Site: https://mercurial-scm.org/
44
45       Source code repository: https://www.mercurial-scm.org/repo/hg
46
47       Mailing list: https://www.mercurial-scm.org/mailman/listinfo/mercurial/
48

COPYING

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

AUTHOR

55       Thomas Arendsen Hein <thomas@intevation.de>
56
57       Organization: Mercurial
58
59
60
61
62                                                                     HG-SSH(8)