README
author Paul Crowley <paul@lshift.net>
Mon, 09 Nov 2009 17:26:11 +0000
changeset 179 243dd21d0dbc
parent 170 0f5e30c85fc3
child 185 f8f8b4018381
permissions -rw-r--r--
Make this version 0.7 (by hand rather clunkily)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
36
b3237aabd0fe Change the name to mercurial-server
Paul Crowley <paul@lshift.net>
parents: 30
diff changeset
     1
mercurial-server
2
a69f7bea408c added a README to describe how this works.
Paul Crowley <paul@lshift.net>
parents:
diff changeset
     2
170
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
     3
mercurial-server gives your developers remote read/write access to centralized Mercurial repositories using SSH public key authentication; it provides convenient and fine-grained key management and access control. 
2
a69f7bea408c added a README to describe how this works.
Paul Crowley <paul@lshift.net>
parents:
diff changeset
     4
101
8b4cdc066967 Link to new mercurial-server website in README
Paul Crowley <paul@lshift.net>
parents: 100
diff changeset
     5
http://www.lshift.net/mercurial-server.html
82
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
     6
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
     7
Copyright (C) 2008-2009 LShift Ltd.
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
     8
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
     9
    This program is free software; you can redistribute it and/or modify
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    10
    it under the terms of the GNU General Public License as published by
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    11
    the Free Software Foundation; either version 2 of the License, or
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    12
    (at your option) any later version.
2
a69f7bea408c added a README to describe how this works.
Paul Crowley <paul@lshift.net>
parents:
diff changeset
    13
82
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    14
    This program is distributed in the hope that it will be useful,
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    15
    but WITHOUT ANY WARRANTY; without even the implied warranty of
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    16
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    17
    GNU General Public License for more details.
2
a69f7bea408c added a README to describe how this works.
Paul Crowley <paul@lshift.net>
parents:
diff changeset
    18
82
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    19
    You should have received a copy of the GNU General Public License along
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    20
    with this program; if not, write to the Free Software Foundation, Inc.,
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    21
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
7369ff737684 License properly
Paul Crowley <paul@lshift.net>
parents: 81
diff changeset
    22
170
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    23
Though mercurial-server is currently targeted at Debian-based systems such as Ubuntu, other users have reported success getting it running on other Unix-based systems such as Red Hat. Running it on a non-Unix system such as Windows is not supported. You will need root privileges to install it. 
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    24
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    25
The best way to install mercurial-server is using your package management system.  However, there is some provision for installing it directly.  On Debian based systems such as Ubuntu, use the command
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    26
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    27
    sudo make setup-adduser
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    28
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    29
On Red Hat and possibly other variants of Unix, try
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    30
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    31
    sudo make setup-useradd
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    32
0f5e30c85fc3 Update README to cover using the makefile
Paul Crowley <paul@lshift.net>
parents: 163
diff changeset
    33
See doc/manual.docbook for the rest of the documentation.
18
538d6b198f4a Big change to support file conditions; format of hg-ssh-access.conf
Paul Crowley <paul@lshift.net>
parents: 15
diff changeset
    34
101
8b4cdc066967 Link to new mercurial-server website in README
Paul Crowley <paul@lshift.net>
parents: 100
diff changeset
    35
Paul Crowley, paul@lshift.net, 2009
8b4cdc066967 Link to new mercurial-server website in README
Paul Crowley <paul@lshift.net>
parents: 100
diff changeset
    36