← 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

Merge lp:bzr.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/server.txt
36
36
SSH
37
37
~~~
38
38
 
39
 
Using Bazaar over SSH requires no special configuration on the server::
 
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`::
40
46
 
41
47
    BZR_REMOTE_PATH=~/bin/bzr bzr log bzr+ssh://host/path/to/branch
42
48
 
43
49
The ``BZR_REMOTE_PATH`` environment variable adjusts how `bzr` will be
44
50
invoked on the remote system.  By default, just `bzr` will be invoked,
45
 
which requires the `bzr` executable to be on the default search path.
 
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``.
46
53
 
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).
 
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.
51
57
 
52
58
inetd
53
59
~~~~~
65
71
 
66
72
    bzr log bzr://host/branchname
67
73
 
 
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
 
68
78
Dedicated
69
79
~~~~~~~~~
70
80