hg-ssh(8) — Linux manual page

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

NAME

       hg-ssh - restricted ssh login shell for Mercurial

SYNOPSIS

       hg-ssh repositories...

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

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

SEE ALSO

       hg(1)

AUTHOR

       Written by Olivia Mackall <olivia@selenic.com>

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

       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

       Thomas Arendsen Hein <thomas@intevation.de>

       Organization: Mercurial

COLOPHON

       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 2024-06-14.  (At that time, the date
       of the most recent commit that was found in the repository was
       2024-04-26.)  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)