← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/server.txt

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2009-04-03 19:03:38 UTC
  • mfrom: (4248.2.1 integration2)
  • Revision ID: pqm@pqm.ubuntu.com-20090403190338-yy0lftj7t2v9vah3
(robertc) Fix handling of fallback repositories some more

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/server.txt
28
28
To maintain the highest security possible, the current
29
29
smart server provides read-only access by default.  To
30
30
enable read-write access, run it with ``--allow-writes``. When using
31
 
the SSH access method, bzr automatically runs with the
 
31
the SSH access method, bzr automatically runs with with the
32
32
``--allow-writes`` option.
33
33
 
34
34
The alternative ways of configuring a smart server are explained below.
36
36
SSH
37
37
~~~
38
38
 
39
 
Using Bazaar over SSH requires no special configuration on the server; so long
40
 
as Bazaar is installed on the server you can use ``bzr+ssh`` URLs, e.g.::
41
 
 
42
 
    bzr log bzr+ssh://host/path/to/branch
43
 
 
44
 
If `bzr` is not installed system-wide on the server you may need to explicitly
45
 
tell the local `bzr` where to find the remote `bzr`::
 
39
Using Bazaar over SSH requires no special configuration on the server::
46
40
 
47
41
    BZR_REMOTE_PATH=~/bin/bzr bzr log bzr+ssh://host/path/to/branch
48
42
 
49
43
The ``BZR_REMOTE_PATH`` environment variable adjusts how `bzr` will be
50
44
invoked on the remote system.  By default, just `bzr` will be invoked,
51
 
which requires the `bzr` executable to be on the default search path.  You can
52
 
also set this permanently per-location in ``locations.conf``.
 
45
which requires the `bzr` executable to be on the default search path.
53
46
 
54
 
Like SFTP, paths starting with ``~`` are relative to your home directory, e.g.
55
 
``bzr+ssh://example.com/~/code/proj``.  Additionally, paths starting with
56
 
``~user`` will be relative to that user's home directory.
 
47
The ``bzr+ssh://`` URL scheme only supports absolute paths from the
 
48
root of the filesystem.  Future versions are expected to support ``~``
 
49
in the same way as ``sftp://`` URLs
 
50
(https://bugs.launchpad.net/bzr/+bug/109143).
57
51
 
58
52
inetd
59
53
~~~~~
71
65
 
72
66
    bzr log bzr://host/branchname
73
67
 
74
 
If possible, paths starting with ``~`` and ``~user`` will be expanded as for
75
 
``bzr+ssh``.  Home directories outside the ``--directory`` specified to ``bzr
76
 
serve`` will not be accessible.
77
 
 
78
68
Dedicated
79
69
~~~~~~~~~
80
70
 
98
88
server::
99
89
 
100
90
    bzr serve --port=localhost:1234 --directory=/srv/bzr/repo
101
 
 
 
91
    
102
92
client::
103
93
 
104
94
    bzr log bzr://localhost:1234/branchname