hg-ssh(8) — Linux manual page

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

NAME         top

       hg-ssh - restricted ssh login shell for Mercurial

SYNOPSIS         top

       hg-ssh repositories...

DESCRIPTION         top

       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): 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         top

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

SEE ALSO         top

       hg(1)

AUTHOR         top

       Written by Olivia Mackall <olivia@selenic.com>

RESOURCES         top

       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         top

       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         top

       Thomas Arendsen Hein <thomas@intevation.de>

       Organization: Mercurial

COLOPHON         top

       This page is part of the hg (Mercurial source code management
       system) project.  Information about the project can be found at 
       ⟨http://mercurial.selenic.com/⟩.  If you have a bug report for this
       manual page, see ⟨http://mercurial.selenic.com/wiki/BugTracker⟩.
       This page was obtained from the project's upstream Mercurial
       repository ⟨http://selenic.com/hg⟩ on 2025-08-11.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2025-08-08.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                                                HG-SSH(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.