0000: 3c 74 69 74 6c 65 3e 46 6f 73 73 69 6c 20 51 75 <title>Fossil Qu
0010: 69 63 6b 20 53 74 61 72 74 20 47 75 69 64 65 3c ick Start Guide<
0020: 2f 74 69 74 6c 65 3e 0a 3c 6e 6f 77 69 6b 69 3e /title>.<nowiki>
0030: 0a 3c 68 31 20 61 6c 69 67 6e 3d 22 63 65 6e 74 .<h1 align="cent
0040: 65 72 22 3e 46 6f 73 73 69 6c 20 51 75 69 63 6b er">Fossil Quick
0050: 20 53 74 61 72 74 3c 2f 68 31 3e 0a 0a 3c 70 3e Start</h1>..<p>
0060: 54 68 69 73 20 69 73 20 61 20 67 75 69 64 65 20 This is a guide
0070: 74 6f 20 67 65 74 20 79 6f 75 20 73 74 61 72 74 to get you start
0080: 65 64 20 75 73 69 6e 67 20 66 6f 73 73 69 6c 20 ed using fossil
0090: 71 75 69 63 6b 6c 79 0a 61 6e 64 20 70 61 69 6e quickly.and pain
00a0: 6c 65 73 73 6c 79 2e 3c 2f 70 3e 0a 0a 3c 68 32 lessly.</p>..<h2
00b0: 3e 49 6e 73 74 61 6c 6c 69 6e 67 3c 2f 68 32 3e >Installing</h2>
00c0: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 <blockquote>..
00d0: 20 20 3c 70 3e 46 6f 73 73 69 6c 20 69 73 20 61 <p>Fossil is a
00e0: 20 73 69 6e 67 6c 65 20 73 65 6c 66 2d 63 6f 6e single self-con
00f0: 74 61 69 6e 65 64 20 43 20 70 72 6f 67 72 61 6d tained C program
0100: 2e 20 20 59 6f 75 20 6e 65 65 64 20 74 6f 0a 20 . You need to.
0110: 20 20 20 65 69 74 68 65 72 20 64 6f 77 6e 6c 6f either downlo
0120: 61 64 20 61 20 0a 20 20 20 20 3c 61 20 68 72 65 ad a . <a hre
0130: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f f="http://www.fo
0140: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 64 6f 77 ssil-scm.org/dow
0150: 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 70 72 65 63 nload.html">prec
0160: 6f 6d 70 69 6c 65 64 20 62 69 6e 61 72 79 3c 2f ompiled binary</
0170: 61 3e 0a 20 20 20 20 6f 72 20 3c 61 20 68 72 65 a>. or <a hre
0180: 66 3d 22 62 75 69 6c 64 2e 77 69 6b 69 22 3e 62 f="build.wiki">b
0190: 75 69 6c 64 20 69 74 20 79 6f 75 72 73 65 6c 66 uild it yourself
01a0: 3c 2f 61 3e 20 66 72 6f 6d 20 73 6f 75 72 63 65 </a> from source
01b0: 73 2e 0a 20 20 20 20 49 6e 73 74 61 6c 6c 20 66 s.. Install f
01c0: 6f 73 73 69 6c 20 62 79 20 70 75 74 74 69 6e 67 ossil by putting
01d0: 20 74 68 65 20 66 6f 73 73 69 6c 20 62 69 6e 61 the fossil bina
01e0: 72 79 0a 20 20 20 20 73 6f 6d 65 70 6c 61 63 65 ry. someplace
01f0: 20 6f 6e 20 79 6f 75 72 20 50 41 54 48 20 65 6e on your PATH en
0200: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
0210: 6c 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62 le.</p>. .</b
0220: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 43 6c lockquote><h2>Cl
0230: 6f 6e 69 6e 67 20 41 6e 20 45 78 69 73 74 69 6e oning An Existin
0240: 67 20 52 65 70 6f 73 69 74 6f 72 79 3c 2f 68 32 g Repository</h2
0250: 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 ><blockquote>..
0260: 20 20 20 3c 70 3e 4d 6f 73 74 20 66 6f 73 73 69 <p>Most fossi
0270: 6c 20 6f 70 65 72 61 74 69 6f 6e 73 20 69 6e 74 l operations int
0280: 65 72 61 63 74 20 77 69 74 68 20 61 20 72 65 70 eract with a rep
0290: 6f 73 69 74 6f 72 79 20 74 68 61 74 20 69 73 20 ository that is
02a0: 6f 6e 20 74 68 65 0a 20 20 20 20 6c 6f 63 61 6c on the. local
02b0: 20 64 69 73 6b 20 64 72 69 76 65 2c 20 6e 6f 74 disk drive, not
02c0: 20 6f 6e 20 61 20 72 65 6d 6f 74 65 20 73 79 73 on a remote sys
02d0: 74 65 6d 2e 20 20 48 65 6e 63 65 2c 20 62 65 66 tem. Hence, bef
02e0: 6f 72 65 20 61 63 63 65 73 73 69 6e 67 0a 20 20 ore accessing.
02f0: 20 20 61 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 a remote repos
0300: 69 74 6f 72 79 20 69 74 20 69 73 20 6e 65 63 65 itory it is nece
0310: 73 73 61 72 79 20 74 6f 20 6d 61 6b 65 20 61 20 ssary to make a
0320: 6c 6f 63 61 6c 20 63 6f 70 79 20 6f 66 20 74 68 local copy of th
0330: 61 74 0a 20 20 20 20 72 65 70 6f 73 69 74 6f 72 at. repositor
0340: 79 2e 20 20 4d 61 6b 69 6e 67 20 61 20 6c 6f 63 y. Making a loc
0350: 61 6c 20 63 6f 70 79 20 6f 66 20 61 20 72 65 6d al copy of a rem
0360: 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 ote repository i
0370: 73 20 63 61 6c 6c 65 64 0a 20 20 20 20 22 63 6c s called. "cl
0380: 6f 6e 69 6e 67 22 2e 3c 2f 70 3e 0a 20 20 20 20 oning".</p>.
0390: 0a 20 20 20 20 3c 70 3e 43 6c 6f 6e 65 20 61 20 . <p>Clone a
03a0: 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 remote repositor
03b0: 79 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 3c 2f 70 y as follows:</p
03c0: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 >. . <bloc
03d0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
03e0: 6f 73 73 69 6c 20 63 6c 6f 6e 65 3c 2f 62 3e 20 ossil clone</b>
03f0: 3c 69 3e 55 52 4c 20 20 72 65 70 6f 73 69 74 6f <i>URL reposito
0400: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a ry-filename</i>.
0410: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
0420: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 68 >. . <p>Th
0430: 65 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 62 6f e <i>URL</i> abo
0440: 76 65 20 69 73 20 74 68 65 20 68 74 74 70 20 55 ve is the http U
0450: 52 4c 20 66 6f 72 20 74 68 65 20 66 6f 73 73 69 RL for the fossi
0460: 6c 20 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20 l repository.
0470: 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 63 6c 6f you want to clo
0480: 6e 65 2c 20 61 6e 64 20 69 74 20 6d 61 79 20 69 ne, and it may i
0490: 6e 63 6c 75 64 65 20 61 20 22 75 73 65 72 3a 70 nclude a "user:p
04a0: 61 73 73 77 6f 72 64 22 20 70 61 72 74 2c 20 65 assword" part, e
04b0: 2e 67 2e 0a 20 20 20 20 3c 74 74 3e 68 74 74 70 .g.. <tt>http
04c0: 3a 2f 2f 64 72 68 3a 73 65 63 72 65 74 40 77 77 ://drh:secret@ww
04d0: 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 w.fossil-scm.org
04e0: 2f 66 6f 73 73 69 6c 3c 2f 74 74 3e 2e 20 59 6f /fossil</tt>. Yo
04f0: 75 20 63 61 6e 0a 20 20 20 20 63 61 6c 6c 20 74 u can. call t
0500: 68 65 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 he new repositor
0510: 79 20 61 6e 79 74 68 69 6e 67 20 79 6f 75 20 77 y anything you w
0520: 61 6e 74 20 2d 20 74 68 65 72 65 20 61 72 65 20 ant - there are
0530: 6e 6f 20 6e 61 6d 69 6e 67 0a 20 20 20 20 72 65 no naming. re
0540: 73 74 72 69 63 74 69 6f 6e 73 2e 20 20 41 73 20 strictions. As
0550: 61 6e 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 an example, you
0560: 63 61 6e 20 63 6c 6f 6e 65 20 74 68 65 20 66 6f can clone the fo
0570: 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 0a ssil repository.
0580: 20 20 20 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 this way:</p
0590: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 >. . <bloc
05a0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
05b0: 6f 73 73 69 6c 20 63 6c 6f 6e 65 20 68 74 74 70 ossil clone http
05c0: 3a 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 ://www.fossil-sc
05d0: 6d 2e 6f 72 67 2f 20 6d 79 63 6c 6f 6e 65 2e 66 m.org/ myclone.f
05e0: 6f 73 73 69 6c 3c 2f 62 3e 0a 20 20 20 20 3c 2f ossil</b>. </
05f0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
0600: 20 3c 70 3e 54 68 65 20 6e 65 77 20 6c 6f 63 61 <p>The new loca
0610: 6c 20 63 6f 70 79 20 6f 66 20 74 68 65 20 72 65 l copy of the re
0620: 73 70 6f 73 69 74 6f 72 79 20 69 73 20 73 74 6f spository is sto
0630: 72 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 red in a single
0640: 66 69 6c 65 2c 0a 20 20 20 20 77 68 69 63 68 20 file,. which
0650: 69 6e 20 74 68 65 20 65 78 61 6d 70 6c 65 20 61 in the example a
0660: 62 6f 76 65 20 69 73 20 6e 61 6d 65 64 20 22 6d bove is named "m
0670: 79 63 6c 6f 6e 65 2e 66 6f 73 73 69 6c 22 2e 0a yclone.fossil"..
0680: 20 20 20 20 59 6f 75 20 63 61 6e 20 6e 61 6d 65 You can name
0690: 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 your repositori
06a0: 65 73 20 61 6e 79 74 68 69 6e 67 20 79 6f 75 20 es anything you
06b0: 77 61 6e 74 2e 20 20 54 68 65 20 22 2e 66 6f 73 want. The ".fos
06c0: 73 69 6c 22 20 73 75 66 66 69 78 0a 20 20 20 20 sil" suffix.
06d0: 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 2e is not required.
06e0: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 3e 4e 6f 74 </p>.. <p>Not
06f0: 65 3a 20 49 66 20 79 6f 75 20 61 72 65 20 62 65 e: If you are be
0700: 68 69 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 hind a restricti
0710: 76 65 20 66 69 72 65 77 61 6c 6c 2c 20 79 6f 75 ve firewall, you
0720: 20 6d 69 67 68 74 20 6e 65 65 64 0a 20 20 20 20 might need.
0730: 74 6f 20 3c 61 20 68 72 65 66 3d 22 23 70 72 6f to <a href="#pro
0740: 78 79 22 3e 73 70 65 63 69 66 79 20 61 6e 20 48 xy">specify an H
0750: 54 54 50 20 70 72 6f 78 79 3c 2f 61 3e 20 74 6f TTP proxy</a> to
0760: 20 75 73 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c use.</p>. .<
0770: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e /blockquote><h2>
0780: 53 74 61 72 74 69 6e 67 20 41 20 4e 65 77 20 50 Starting A New P
0790: 72 6f 6a 65 63 74 3c 2f 68 32 3e 3c 62 6c 6f 63 roject</h2><bloc
07a0: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
07b0: 54 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 To start a new p
07c0: 72 6f 6a 65 63 74 20 77 69 74 68 20 66 6f 73 73 roject with foss
07d0: 69 6c 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 il, create a new
07e0: 20 65 6d 70 74 79 20 72 65 70 6f 73 69 74 6f 72 empty repositor
07f0: 79 0a 20 20 20 20 74 68 69 73 20 77 61 79 3a 3c y. this way:<
0800: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c /p>. . <bl
0810: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
0820: 3e 66 6f 73 73 69 6c 20 6e 65 77 20 3c 2f 62 3e >fossil new </b>
0830: 3c 69 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 <i> repository-f
0840: 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 ilename</i>.
0850: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 </blockquote>.
0860: 20 20 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e .</blockquote>
0870: 3c 68 32 3e 43 6f 6e 66 69 67 75 72 69 6e 67 20 <h2>Configuring
0880: 59 6f 75 72 20 4c 6f 63 61 6c 20 52 65 70 6f 73 Your Local Repos
0890: 69 74 6f 72 79 3c 2f 68 32 3e 3c 62 6c 6f 63 6b itory</h2><block
08a0: 71 75 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 quote>. .
08b0: 3c 70 3e 57 68 65 6e 20 79 6f 75 20 63 72 65 61 <p>When you crea
08c0: 74 65 20 61 20 6e 65 77 20 72 65 70 6f 73 69 74 te a new reposit
08d0: 6f 72 79 2c 20 65 69 74 68 65 72 20 62 79 20 63 ory, either by c
08e0: 6c 6f 6e 69 6e 67 20 61 6e 20 65 78 69 73 74 69 loning an existi
08f0: 6e 67 0a 20 20 20 20 70 72 6f 6a 65 63 74 20 6f ng. project o
0900: 72 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 70 r create a new p
0910: 72 6f 6a 65 63 74 20 6f 66 20 79 6f 75 72 20 6f roject of your o
0920: 77 6e 2c 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 wn, you usually
0930: 77 61 6e 74 20 74 6f 20 64 6f 20 73 6f 6d 65 0a want to do some.
0940: 20 20 20 20 6c 6f 63 61 6c 20 63 6f 6e 66 69 67 local config
0950: 75 72 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 uration. This i
0960: 73 20 65 61 73 69 6c 79 20 61 63 63 6f 6d 70 6c s easily accompl
0970: 69 73 68 65 64 20 75 73 69 6e 67 20 74 68 65 20 ished using the
0980: 77 65 62 73 65 72 76 65 72 0a 20 20 20 20 74 68 webserver. th
0990: 61 74 20 69 73 20 62 75 69 6c 74 20 69 6e 74 6f at is built into
09a0: 20 66 6f 73 73 69 6c 2e 20 20 53 74 61 72 74 20 fossil. Start
09b0: 74 68 65 20 66 6f 73 73 69 6c 20 77 65 62 73 65 the fossil webse
09c0: 72 76 65 72 20 6c 69 6b 65 20 74 68 69 73 3a 3c rver like this:<
09d0: 2f 70 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c /p>. . <bl
09e0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
09f0: 3e 66 6f 73 73 69 6c 20 75 69 20 3c 2f 62 3e 3c >fossil ui </b><
0a00: 69 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 i> repository-fi
0a10: 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c lename</i>. <
0a20: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
0a30: 20 20 3c 70 3e 54 68 69 73 20 73 74 61 72 74 73 <p>This starts
0a40: 20 61 20 77 65 62 73 65 72 76 65 72 20 6c 69 73 a webserver lis
0a50: 74 65 6e 69 6e 67 20 6f 6e 20 70 6f 72 74 20 38 tening on port 8
0a60: 30 38 30 2e 20 20 59 6f 75 20 63 61 6e 0a 20 20 080. You can.
0a70: 20 20 73 70 65 63 69 66 79 20 61 20 64 69 66 66 specify a diff
0a80: 65 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e 67 erent port using
0a90: 20 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f 62 the <b>-port</b
0aa0: 3e 20 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 20 > option on the
0ab0: 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a 20 20 command-line..
0ac0: 20 20 41 66 74 65 72 20 74 68 65 20 73 65 72 76 After the serv
0ad0: 65 72 20 69 73 20 72 75 6e 6e 69 6e 67 2c 20 66 er is running, f
0ae0: 6f 73 73 69 6c 20 77 69 6c 6c 20 74 68 65 6e 20 ossil will then
0af0: 61 74 74 65 6d 70 74 20 74 6f 20 6c 61 75 6e 63 attempt to launc
0b00: 68 20 79 6f 75 72 0a 20 20 20 20 77 65 62 20 62 h your. web b
0b10: 72 6f 77 73 65 72 20 61 6e 64 20 6d 61 6b 65 20 rowser and make
0b20: 69 74 20 70 6f 69 6e 74 20 74 6f 20 74 68 69 73 it point to this
0b30: 20 77 65 62 20 73 65 72 76 65 72 2e 20 20 49 66 web server. If
0b40: 20 79 6f 75 72 20 73 79 73 74 65 6d 0a 20 20 20 your system.
0b50: 20 68 61 73 20 61 6e 20 75 6e 75 73 75 61 6c 20 has an unusual
0b60: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 66 configuration, f
0b70: 6f 73 73 69 6c 20 6d 69 67 68 74 20 6e 6f 74 20 ossil might not
0b80: 62 65 20 61 62 6c 65 20 74 6f 20 66 69 67 75 72 be able to figur
0b90: 65 20 6f 75 74 0a 20 20 20 20 68 6f 77 20 74 6f e out. how to
0ba0: 20 73 74 61 72 74 20 79 6f 75 72 20 77 65 62 20 start your web
0bb0: 62 72 6f 77 73 65 72 2e 20 20 49 6e 20 74 68 61 browser. In tha
0bc0: 74 20 63 61 73 65 2c 20 73 74 61 72 74 20 74 68 t case, start th
0bd0: 65 20 77 65 62 20 62 72 6f 77 73 65 72 0a 20 20 e web browser.
0be0: 20 20 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 70 yourself and p
0bf0: 6f 69 6e 74 20 69 74 20 61 74 20 68 74 74 70 3a oint it at http:
0c00: 2f 2f 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 30 //localhost:8080
0c10: 2f 2e 20 20 43 6c 69 63 6b 20 6f 6e 20 74 68 65 /. Click on the
0c20: 0a 20 20 20 20 22 41 64 6d 69 6e 22 20 6c 69 6e . "Admin" lin
0c30: 6b 20 6f 6e 20 74 68 65 20 6d 65 6e 75 20 62 61 k on the menu ba
0c40: 72 20 74 6f 20 73 74 61 72 74 20 63 6f 6e 66 69 r to start confi
0c50: 67 75 72 69 6e 67 20 79 6f 75 72 20 72 65 70 6f guring your repo
0c60: 73 69 74 6f 72 79 2e 3c 2f 70 3e 0a 20 20 20 20 sitory.</p>.
0c70: 0a 20 20 20 20 3c 70 3e 42 79 20 64 65 66 61 75 . <p>By defau
0c80: 6c 74 2c 20 66 6f 73 73 69 6c 20 64 6f 65 73 20 lt, fossil does
0c90: 6e 6f 74 20 72 65 71 75 69 72 65 20 61 20 6c 6f not require a lo
0ca0: 67 69 6e 20 66 6f 72 20 48 54 54 50 20 63 6f 6e gin for HTTP con
0cb0: 6e 65 63 74 69 6f 6e 73 0a 20 20 20 20 63 6f 6d nections. com
0cc0: 69 6e 67 20 69 6e 20 66 72 6f 6d 20 74 68 65 20 ing in from the
0cd0: 49 50 20 6c 6f 6f 70 62 61 63 6b 20 61 64 64 72 IP loopback addr
0ce0: 65 73 73 20 31 32 37 2e 30 2e 30 2e 31 2e 20 20 ess 127.0.0.1.
0cf0: 59 6f 75 20 63 61 6e 2c 20 61 6e 64 20 70 65 72 You can, and per
0d00: 68 61 70 73 0a 20 20 20 20 73 68 6f 75 6c 64 2c haps. should,
0d10: 20 63 68 61 6e 67 65 20 74 68 69 73 20 61 66 74 change this aft
0d20: 65 72 20 79 6f 75 20 63 72 65 61 74 65 20 61 20 er you create a
0d30: 66 65 77 20 75 73 65 72 73 2e 3c 2f 70 3e 0a 20 few users.</p>.
0d40: 20 20 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 . <p>When
0d50: 79 6f 75 20 61 72 65 20 66 69 6e 69 73 68 65 64 you are finished
0d60: 20 63 6f 6e 66 69 67 75 72 69 6e 67 2c 20 6a 75 configuring, ju
0d70: 73 74 20 70 72 65 73 73 20 43 6f 6e 74 72 6f 6c st press Control
0d80: 2d 43 20 6f 72 20 75 73 65 0a 20 20 20 20 74 68 -C or use. th
0d90: 65 20 3c 62 3e 6b 69 6c 6c 3c 2f 62 3e 20 63 6f e <b>kill</b> co
0da0: 6d 6d 61 6e 64 20 74 6f 20 73 68 75 74 20 64 6f mmand to shut do
0db0: 77 6e 20 74 68 65 20 6d 69 6e 69 2d 73 65 72 76 wn the mini-serv
0dc0: 65 72 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b er.</p>..</block
0dd0: 71 75 6f 74 65 3e 3c 68 32 3e 43 68 65 63 6b 69 quote><h2>Checki
0de0: 6e 67 20 4f 75 74 20 41 20 4c 6f 63 61 6c 20 54 ng Out A Local T
0df0: 72 65 65 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ree</h2><blockqu
0e00: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 ote>.. <p>To
0e10: 77 6f 72 6b 20 6f 6e 20 61 20 70 72 6f 6a 65 63 work on a projec
0e20: 74 20 69 6e 20 66 6f 73 73 69 6c 2c 20 79 6f 75 t in fossil, you
0e30: 20 6e 65 65 64 20 74 6f 20 63 68 65 63 6b 20 6f need to check o
0e40: 75 74 20 61 20 6c 6f 63 61 6c 0a 20 20 20 20 63 ut a local. c
0e50: 6f 70 79 20 6f 66 20 74 68 65 20 73 6f 75 72 63 opy of the sourc
0e60: 65 20 74 72 65 65 2e 20 20 43 72 65 61 74 65 20 e tree. Create
0e70: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 79 6f the directory yo
0e80: 75 20 77 61 6e 74 20 74 6f 20 62 65 0a 20 20 20 u want to be.
0e90: 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 79 6f 75 the root of you
0ea0: 72 20 74 72 65 65 20 61 6e 64 20 63 64 20 69 6e r tree and cd in
0eb0: 74 6f 20 74 68 61 74 20 64 69 72 65 63 74 6f 72 to that director
0ec0: 79 2e 20 20 54 68 65 6e 0a 20 20 20 20 64 6f 20 y. Then. do
0ed0: 74 68 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 this:</p>. .
0ee0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
0ef0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6f 70 <b>fossil op
0f00: 65 6e 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 en </b><i> repos
0f10: 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f itory-filename</
0f20: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
0f30: 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 ote>. . <p
0f40: 3e 54 68 69 73 20 6c 65 61 76 65 73 20 79 6f 75 >This leaves you
0f50: 20 77 69 74 68 20 74 68 65 20 6e 65 77 65 73 74 with the newest
0f60: 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 version of the
0f70: 74 72 65 65 0a 20 20 20 20 63 68 65 63 6b 65 64 tree. checked
0f80: 20 6f 75 74 2e 20 20 20 20 0a 20 20 20 20 46 72 out. . Fr
0f90: 6f 6d 20 61 6e 79 77 68 65 72 65 20 75 6e 64 65 om anywhere unde
0fa0: 72 6e 65 61 74 68 20 74 68 65 20 72 6f 6f 74 20 rneath the root
0fb0: 6f 66 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 of your local tr
0fc0: 65 65 2c 20 79 6f 75 0a 20 20 20 20 63 61 6e 20 ee, you. can
0fd0: 74 79 70 65 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 type commands li
0fe0: 6b 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ke the following
0ff0: 20 74 6f 20 66 69 6e 64 20 6f 75 74 20 74 68 65 to find out the
1000: 20 73 74 61 74 75 73 20 6f 66 0a 20 20 20 20 79 status of. y
1010: 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65 65 3a 3c our local tree:<
1020: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
1030: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
1040: 73 69 6c 20 69 6e 66 6f 3c 2f 62 3e 3c 62 72 3e sil info</b><br>
1050: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 . <b>fossil s
1060: 74 61 74 75 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 tatus</b><br>.
1070: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 68 61 6e <b>fossil chan
1080: 67 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 ges</b><br>.
1090: 3c 62 3e 66 6f 73 73 69 6c 20 74 69 6d 65 6c 69 <b>fossil timeli
10a0: 6e 65 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c ne</b><br>. <
10b0: 62 3e 66 6f 73 73 69 6c 20 6c 65 61 76 65 73 3c b>fossil leaves<
10c0: 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /b><br>. <b>f
10d0: 6f 73 73 69 6c 20 6c 73 3c 2f 62 3e 3c 62 72 3e ossil ls</b><br>
10e0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 62 . <b>fossil b
10f0: 72 61 6e 63 68 20 6c 69 73 74 3c 2f 62 3e 3c 62 ranch list</b><b
1100: 72 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 r>. </blockqu
1110: 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f ote>..</blockquo
1120: 74 65 3e 3c 68 32 3e 4d 61 6b 69 6e 67 20 43 68 te><h2>Making Ch
1130: 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b anges</h2><block
1140: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T
1150: 6f 20 61 64 64 20 6e 65 77 20 66 69 6c 65 73 20 o add new files
1160: 74 6f 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 2c to your project,
1170: 20 6f 72 20 72 65 6d 6f 76 65 20 6f 6c 64 20 66 or remove old f
1180: 69 6c 65 73 2c 20 75 73 65 20 74 68 65 73 65 0a iles, use these.
1190: 20 20 20 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 commands:</p
11a0: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
11b0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
11c0: 6c 20 61 64 64 3c 2f 62 3e 20 3c 69 3e 66 69 6c l add</b> <i>fil
11d0: 65 2e 2e 2e 3c 2f 69 3e 3c 62 72 3e 0a 20 20 20 e...</i><br>.
11e0: 20 3c 62 3e 66 6f 73 73 69 6c 20 72 6d 3c 2f 62 <b>fossil rm</b
11f0: 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c 2f 69 3e > <i>file...</i>
1200: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
1210: 65 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 e>.. <p>You c
1220: 61 6e 20 61 6c 73 6f 20 65 64 69 74 20 66 69 6c an also edit fil
1230: 65 73 20 66 72 65 65 6c 79 2e 20 20 4f 6e 63 65 es freely. Once
1240: 20 79 6f 75 20 61 72 65 20 72 65 61 64 79 20 74 you are ready t
1250: 6f 20 63 6f 6d 6d 69 74 0a 20 20 20 20 79 6f 75 o commit. you
1260: 72 20 63 68 61 6e 67 65 73 2c 20 74 79 70 65 3a r changes, type:
1270: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block
1280: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo
1290: 73 73 69 6c 20 63 6f 6d 6d 69 74 3c 2f 62 3e 0a ssil commit</b>.
12a0: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
12b0: 3e 0a 0a 20 20 20 20 3c 70 3e 59 6f 75 20 77 69 >.. <p>You wi
12c0: 6c 6c 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 ll be prompted f
12d0: 6f 72 20 63 68 65 63 6b 2d 69 6e 20 63 6f 6d 6d or check-in comm
12e0: 65 6e 74 73 20 75 73 69 6e 67 20 77 68 61 74 65 ents using whate
12f0: 76 65 72 20 65 64 69 74 6f 72 0a 20 20 20 20 69 ver editor. i
1300: 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 79 s specified by y
1310: 6f 75 72 20 56 49 53 55 41 4c 20 6f 72 20 45 44 our VISUAL or ED
1320: 49 54 4f 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 ITOR environment
1330: 20 76 61 72 69 61 62 6c 65 2e 20 20 49 66 20 79 variable. If y
1340: 6f 75 0a 20 20 20 20 68 61 76 65 20 47 50 47 20 ou. have GPG
1350: 69 6e 73 74 61 6c 6c 65 64 2c 20 79 6f 75 20 6d installed, you m
1360: 61 79 20 62 65 20 70 72 6f 6d 70 74 65 64 20 66 ay be prompted f
1370: 6f 72 20 79 6f 75 72 20 47 50 47 20 70 61 73 73 or your GPG pass
1380: 70 68 72 61 73 65 20 73 6f 0a 20 20 20 20 74 68 phrase so. th
1390: 61 74 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 at the check-in
13a0: 63 61 6e 20 62 65 20 73 69 67 6e 65 64 20 77 69 can be signed wi
13b0: 74 68 20 79 6f 75 72 20 47 50 47 20 73 69 67 6e th your GPG sign
13c0: 61 74 75 72 65 2e 20 20 41 66 74 65 72 0a 20 20 ature. After.
13d0: 20 20 74 68 69 73 20 79 6f 75 72 20 63 68 61 6e this your chan
13e0: 67 65 73 20 77 69 6c 6c 20 62 65 20 63 68 65 63 ges will be chec
13f0: 6b 65 64 20 69 6e 2e 3c 2f 70 3e 0a 0a 3c 2f 62 ked in.</p>..</b
1400: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 68 lockquote><h2>Sh
1410: 61 72 69 6e 67 20 43 68 61 6e 67 65 73 3c 2f 68 aring Changes</h
1420: 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 2><blockquote>..
1430: 20 20 20 20 3c 70 3e 54 68 65 20 63 68 61 6e 67 <p>The chang
1440: 65 73 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 es you <b>commit
1450: 3c 2f 62 3e 20 61 72 65 20 6f 6e 6c 79 20 6f 6e </b> are only on
1460: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f your local repo
1470: 73 69 74 6f 72 79 2e 0a 20 20 20 20 54 6f 20 73 sitory.. To s
1480: 68 61 72 65 20 74 68 6f 73 65 20 63 68 61 6e 67 hare those chang
1490: 65 73 20 77 69 74 68 20 6f 74 68 65 72 20 72 65 es with other re
14a0: 70 6f 73 69 74 6f 72 69 65 73 2c 20 64 6f 3a 3c positories, do:<
14b0: 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /p>.. <blockq
14c0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
14d0: 73 69 6c 20 70 75 73 68 3c 2f 62 3e 20 3c 69 3e sil push</b> <i>
14e0: 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c URL</i>. </bl
14f0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
1500: 70 3e 57 68 65 72 65 20 3c 69 3e 55 52 4c 3c 2f p>Where <i>URL</
1510: 69 3e 20 69 73 20 74 68 65 20 68 74 74 70 3a 20 i> is the http:
1520: 55 52 4c 20 6f 66 20 74 68 65 20 73 65 72 76 65 URL of the serve
1530: 72 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 r repository you
1540: 0a 20 20 20 20 77 61 6e 74 20 74 6f 20 73 68 61 . want to sha
1550: 72 65 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 re your changes
1560: 77 69 74 68 2e 20 20 49 66 20 79 6f 75 20 6f 6d with. If you om
1570: 69 74 20 74 68 65 20 3c 69 3e 55 52 4c 3c 2f 69 it the <i>URL</i
1580: 3e 20 61 72 67 75 6d 65 6e 74 2c 0a 20 20 20 20 > argument,.
1590: 66 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 65 20 fossil will use
15a0: 77 68 61 74 65 76 65 72 20 73 65 72 76 65 72 20 whatever server
15b0: 79 6f 75 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c you most recentl
15c0: 79 20 73 79 6e 63 65 64 20 77 69 74 68 2e 3c 2f y synced with.</
15d0: 70 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 3c p>.. <p>The <
15e0: 62 3e 70 75 73 68 3c 2f 62 3e 20 63 6f 6d 6d 61 b>push</b> comma
15f0: 6e 64 20 6f 6e 6c 79 20 73 65 6e 64 73 20 79 6f nd only sends yo
1600: 75 72 20 63 68 61 6e 67 65 73 20 74 6f 20 6f 74 ur changes to ot
1610: 68 65 72 73 2e 20 20 54 6f 0a 20 20 20 20 52 65 hers. To. Re
1620: 63 65 69 76 65 20 63 68 61 6e 67 65 73 20 66 72 ceive changes fr
1630: 6f 6d 20 6f 74 68 65 72 73 2c 20 75 73 65 20 3c om others, use <
1640: 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 20 20 4f 72 20 b>pull</b>. Or
1650: 67 6f 20 62 6f 74 68 20 77 61 79 73 20 61 74 0a go both ways at.
1660: 20 20 20 20 6f 6e 63 65 20 75 73 69 6e 67 20 3c once using <
1670: 62 3e 73 79 6e 63 3c 2f 62 3e 3a 3c 2f 70 3e 0a b>sync</b>:</p>.
1680: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
1690: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
16a0: 70 75 6c 6c 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c pull</b> <i>URL<
16b0: 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /i><br>. <b>f
16c0: 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 62 3e 20 3c ossil sync</b> <
16d0: 69 3e 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f i>URL</i>. </
16e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
16f0: 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 70 75 6c <p>When you pul
1700: 6c 20 69 6e 20 63 68 61 6e 67 65 73 20 66 72 6f l in changes fro
1710: 6d 20 6f 74 68 65 72 73 2c 20 74 68 65 79 20 67 m others, they g
1720: 6f 20 69 6e 74 6f 20 79 6f 75 72 20 72 65 70 6f o into your repo
1730: 73 69 74 6f 72 79 2c 0a 20 20 20 20 6e 6f 74 20 sitory,. not
1740: 69 6e 74 6f 20 79 6f 75 72 20 63 68 65 63 6b 65 into your checke
1750: 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 72 65 65 d-out local tree
1760: 2e 20 20 54 6f 20 67 65 74 20 74 68 65 20 63 68 . To get the ch
1770: 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 72 0a anges into your.
1780: 20 20 20 20 6c 6f 63 61 6c 20 74 72 65 65 2c 20 local tree,
1790: 75 73 65 20 3c 62 3e 75 70 64 61 74 65 3c 2f 62 use <b>update</b
17a0: 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f >:</p>.. <blo
17b0: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
17c0: 66 6f 73 73 69 6c 20 75 70 64 61 74 65 3c 2f 62 fossil update</b
17d0: 3e 20 3c 69 3e 41 49 44 3c 2f 69 3e 0a 20 20 20 > <i>AID</i>.
17e0: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>..
17f0: 20 20 20 20 3c 70 3e 54 68 65 20 3c 69 3e 41 49 <p>The <i>AI
1800: 44 3c 2f 69 3e 20 69 73 20 73 6f 6d 65 20 75 6e D</i> is some un
1810: 69 71 75 65 20 61 62 62 72 65 76 69 61 74 69 6f ique abbreviatio
1820: 6e 20 74 6f 20 74 68 65 20 34 30 2d 63 68 61 72 n to the 40-char
1830: 61 63 74 65 72 0a 20 20 20 20 61 72 74 69 66 61 acter. artifa
1840: 63 74 20 69 64 65 6e 74 69 66 69 65 72 20 28 41 ct identifier (A
1850: 49 44 29 20 66 6f 72 20 61 20 70 61 72 74 69 63 ID) for a partic
1860: 75 6c 61 72 20 63 68 65 63 6b 2d 69 6e 2e 20 20 ular check-in.
1870: 49 66 20 79 6f 75 20 6f 6d 69 74 0a 20 20 20 20 If you omit.
1880: 74 68 65 20 3c 69 3e 41 49 44 3c 2f 69 3e 20 66 the <i>AID</i> f
1890: 6f 73 73 69 6c 20 6d 6f 76 65 73 20 79 6f 75 20 ossil moves you
18a0: 74 6f 20 74 68 65 0a 20 20 20 20 6c 65 61 66 20 to the. leaf
18b0: 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 62 version of the b
18c0: 72 61 6e 63 68 20 79 6f 75 72 20 61 72 65 20 63 ranch your are c
18d0: 75 72 72 65 6e 74 6c 79 20 6f 6e 2e 20 20 49 66 urrently on. If
18e0: 20 79 6f 75 72 20 62 72 61 6e 63 68 0a 20 20 20 your branch.
18f0: 20 68 61 73 20 6d 75 6c 74 69 70 6c 65 20 6c 65 has multiple le
1900: 61 76 65 73 2c 20 79 6f 75 20 67 65 74 20 61 6e aves, you get an
1910: 20 65 72 72 6f 72 20 2d 20 79 6f 75 27 6c 6c 20 error - you'll
1920: 68 61 76 65 20 74 6f 20 73 70 65 63 69 66 79 20 have to specify
1930: 74 68 65 0a 20 20 20 20 6c 65 61 66 20 79 6f 75 the. leaf you
1940: 20 77 61 6e 74 20 75 73 69 6e 67 20 61 20 3c 69 want using a <i
1950: 3e 41 49 44 3c 2f 69 3e 20 61 72 67 75 6d 65 6e >AID</i> argumen
1960: 74 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 t.</p>..</blockq
1970: 75 6f 74 65 3e 3c 68 32 3e 42 72 61 6e 63 68 69 uote><h2>Branchi
1980: 6e 67 20 41 6e 64 20 4d 65 72 67 69 6e 67 3c 2f ng And Merging</
1990: 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a h2><blockquote>.
19a0: 0a 20 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 . <p>You can
19b0: 63 72 65 61 74 65 20 62 72 61 6e 63 68 65 73 20 create branches
19c0: 62 79 20 64 6f 69 6e 67 20 6d 75 6c 74 69 70 6c by doing multipl
19d0: 65 20 63 6f 6d 6d 69 74 73 20 6f 66 66 20 6f 66 e commits off of
19e0: 20 74 68 65 0a 20 20 20 20 73 61 6d 65 20 62 61 the. same ba
19f0: 73 65 20 76 65 72 73 69 6f 6e 2e 20 20 54 6f 20 se version. To
1a00: 6d 65 72 67 65 20 74 6f 20 62 72 61 6e 63 68 65 merge to branche
1a10: 73 20 62 61 63 6b 20 74 6f 67 65 74 68 65 72 2c s back together,
1a20: 20 66 69 72 73 74 0a 20 20 20 20 3c 62 3e 75 70 first. <b>up
1a30: 64 61 74 65 3c 2f 62 3e 20 74 6f 20 74 68 65 20 date</b> to the
1a40: 6c 65 61 66 20 6f 66 20 6f 6e 65 20 62 72 61 6e leaf of one bran
1a50: 63 68 2e 20 20 54 68 65 6e 20 64 6f 20 61 20 3c ch. Then do a <
1a60: 62 3e 6d 65 72 67 65 3c 2f 62 3e 0a 20 20 20 20 b>merge</b>.
1a70: 6f 66 20 74 68 65 20 6c 65 61 66 20 6f 66 20 74 of the leaf of t
1a80: 68 65 20 6f 74 68 65 72 20 62 72 61 6e 63 68 3a he other branch:
1a90: 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b </p>.. <block
1aa0: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f quote>. <b>fo
1ab0: 73 73 69 6c 20 6d 65 72 67 65 3c 2f 62 3e 20 3c ssil merge</b> <
1ac0: 69 3e 41 49 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f i>AID</i>. </
1ad0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
1ae0: 20 3c 70 3e 54 65 73 74 20 74 6f 20 6d 61 6b 65 <p>Test to make
1af0: 20 73 75 72 65 20 79 6f 75 72 20 6d 65 72 67 65 sure your merge
1b00: 20 64 69 64 6e 27 74 20 6d 65 73 73 20 75 70 20 didn't mess up
1b10: 74 68 65 20 63 6f 64 65 2c 20 74 68 65 6e 0a 20 the code, then.
1b20: 20 20 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e <b>commit</b>
1b30: 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 61 6c and possibly al
1b40: 73 6f 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 20 79 so <b>push</b> y
1b50: 6f 75 72 20 63 68 61 6e 67 65 73 2e 20 20 20 52 our changes. R
1b60: 65 6d 65 6d 62 65 72 0a 20 20 20 20 74 68 61 74 emember. that
1b70: 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20 63 61 6e nobody else can
1b80: 20 73 65 65 20 79 6f 75 72 20 63 68 61 6e 67 65 see your change
1b90: 73 20 75 6e 74 69 6c 20 79 6f 75 20 3c 62 3e 63 s until you <b>c
1ba0: 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 0a 20 20 ommit</b> and.
1bb0: 20 20 69 66 20 6f 74 68 65 72 20 61 72 65 20 75 if other are u
1bc0: 73 69 6e 67 20 61 20 64 69 66 66 65 72 65 6e 74 sing a different
1bd0: 20 72 65 70 6f 73 69 74 6f 72 79 20 79 6f 75 20 repository you
1be0: 77 69 6c 6c 20 61 6c 73 6f 20 6e 65 65 64 20 74 will also need t
1bf0: 6f 0a 20 20 20 20 3c 62 3e 70 75 73 68 3c 2f 62 o. <b>push</b
1c00: 3e 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65 3d >.</p>..<a name=
1c10: 22 73 65 72 76 65 72 73 65 74 75 70 22 3e 3c 2f "serversetup"></
1c20: 61 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e a>.</blockquote>
1c30: 3c 68 32 3e 53 65 74 74 69 6e 67 20 55 70 20 41 <h2>Setting Up A
1c40: 20 53 65 72 76 65 72 3c 2f 68 32 3e 3c 62 6c 6f Server</h2><blo
1c50: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
1c60: 3e 54 68 65 20 65 61 73 69 65 73 74 20 77 61 79 >The easiest way
1c70: 20 74 6f 20 73 65 74 20 75 70 20 61 20 73 65 72 to set up a ser
1c80: 76 65 72 20 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 ver is:</p>..
1c90: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
1ca0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 72 76 <b>fossil serv
1cb0: 65 72 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 er</b> <i>reposi
1cc0: 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 tory-filename</i
1cd0: 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f >. </blockquo
1ce0: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 3c 2f te>.. <p>Or</
1cf0: 62 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 b>.. <blockqu
1d00: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss
1d10: 69 6c 20 75 69 3c 2f 62 3e 20 3c 69 3e 72 65 70 il ui</b> <i>rep
1d20: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename
1d30: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block
1d40: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T
1d50: 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 he difference be
1d60: 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f 20 tween these two
1d70: 63 6f 6d 6d 61 6e 64 20 69 73 20 74 68 61 74 20 command is that
1d80: 3c 62 3e 75 69 3c 2f 62 3e 0a 20 20 20 20 61 74 <b>ui</b>. at
1d90: 74 65 6d 70 74 73 20 74 6f 20 61 75 74 6f 6d 61 tempts to automa
1da0: 74 69 63 61 6c 6c 79 20 73 74 61 72 74 20 79 6f tically start yo
1db0: 75 72 20 77 65 62 20 62 72 6f 77 73 65 72 20 70 ur web browser p
1dc0: 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 0a 20 ointing at the.
1dd0: 20 20 20 73 65 72 76 65 72 20 77 68 65 72 65 61 server wherea
1de0: 73 20 3c 62 3e 73 65 72 76 65 72 3c 2f 62 3e 20 s <b>server</b>
1df0: 64 6f 65 73 20 6e 6f 74 2e 0a 20 20 20 20 59 6f does not.. Yo
1e00: 75 20 63 61 6e 20 6f 6d 69 74 20 74 68 65 20 3c u can omit the <
1e10: 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c i>repository-fil
1e20: 65 6e 61 6d 65 3c 2f 69 3e 20 69 66 20 79 6f 75 ename</i> if you
1e30: 20 61 72 65 20 77 69 74 68 69 6e 0a 20 20 20 20 are within.
1e40: 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 6c 6f a checked-out lo
1e50: 63 61 6c 20 74 72 65 65 2e 20 20 54 68 69 73 20 cal tree. This
1e60: 73 65 72 76 65 72 20 75 73 65 73 20 70 6f 72 74 server uses port
1e70: 20 38 30 38 30 20 62 79 20 64 65 66 61 75 6c 74 8080 by default
1e80: 0a 20 20 20 20 62 75 74 20 79 6f 75 20 63 61 6e . but you can
1e90: 20 73 70 65 63 69 66 79 20 61 20 64 69 66 66 65 specify a diffe
1ea0: 72 65 6e 74 20 70 6f 72 74 20 75 73 69 6e 67 20 rent port using
1eb0: 74 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f 62 3e the <b>-port</b>
1ec0: 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 0a 20 command.</p>..
1ed0: 20 20 20 3c 70 3e 43 6f 6d 6d 61 6e 64 2d 6c 69 <p>Command-li
1ee0: 6e 65 20 73 65 72 76 65 72 73 20 6c 69 6b 65 20 ne servers like
1ef0: 74 68 69 73 20 61 72 65 20 75 73 65 66 75 6c 20 this are useful
1f00: 77 68 65 6e 20 74 77 6f 20 70 65 6f 70 6c 65 20 when two people
1f10: 77 61 6e 74 0a 20 20 20 20 74 6f 20 73 68 61 72 want. to shar
1f20: 65 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 6f e a repository o
1f30: 6e 20 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 61 n temporary or a
1f40: 64 2d 68 6f 63 20 62 61 73 69 73 2e 20 20 46 6f d-hoc basis. Fo
1f50: 72 20 61 20 6d 6f 72 65 0a 20 20 20 20 70 65 72 r a more. per
1f60: 6d 61 6e 65 6e 74 20 69 6e 73 74 61 6c 6c 61 74 manent installat
1f70: 69 6f 6e 2c 20 79 6f 75 20 73 68 6f 75 6c 64 20 ion, you should
1f80: 75 73 65 20 65 69 74 68 65 72 20 74 68 65 20 43 use either the C
1f90: 47 49 20 73 65 72 76 65 72 20 6f 72 20 74 68 65 GI server or the
1fa0: 0a 20 20 20 20 69 6e 65 74 64 20 73 65 72 76 65 . inetd serve
1fb0: 72 2e 0a 20 20 20 20 3c 61 20 6e 61 6d 65 3d 22 r.. <a name="
1fc0: 63 67 69 73 65 72 76 65 72 22 3e 3c 2f 61 3e 0a cgiserver"></a>.
1fd0: 20 20 20 20 54 6f 20 75 73 65 20 74 68 65 20 43 To use the C
1fe0: 47 49 20 73 65 72 76 65 72 2c 20 63 72 65 61 74 GI server, creat
1ff0: 65 20 61 20 43 47 49 20 73 63 72 69 70 74 20 74 e a CGI script t
2000: 68 61 74 0a 20 20 20 20 6c 6f 6f 6b 73 20 73 6f hat. looks so
2010: 6d 65 74 68 69 6e 67 20 6c 69 6b 65 20 74 68 69 mething like thi
2020: 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f s:</p>.. <blo
2030: 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 ckquote><b>.
2040: 23 21 2f 75 73 72 2f 6c 6f 63 61 6c 2f 62 69 6e #!/usr/local/bin
2050: 2f 66 6f 73 73 69 6c 3c 62 72 3e 0a 20 20 20 20 /fossil<br>.
2060: 72 65 70 6f 73 69 74 6f 72 79 3a 20 2f 68 6f 6d repository: /hom
2070: 65 2f 70 72 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 e/proj1/repos1.f
2080: 6f 73 73 69 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f ossil. </b></
2090: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
20a0: 20 3c 70 3e 41 64 6a 75 73 74 20 74 68 65 20 70 <p>Adjust the p
20b0: 61 74 68 73 20 69 6e 20 74 68 69 73 20 43 47 49 aths in this CGI
20c0: 20 73 63 72 69 70 74 20 74 6f 20 6d 61 74 63 68 script to match
20d0: 20 79 6f 75 72 20 69 6e 73 74 61 6c 6c 61 74 69 your installati
20e0: 6f 6e 0a 20 20 20 20 61 6e 64 20 6d 61 6b 65 20 on. and make
20f0: 73 75 72 65 20 74 68 61 74 20 72 65 70 6f 73 69 sure that reposi
2100: 74 6f 72 79 20 66 69 6c 65 20 61 74 20 74 68 65 tory file at the
2110: 20 64 69 72 65 63 74 6f 72 79 20 74 68 61 74 20 directory that
2120: 63 6f 6e 74 61 69 6e 73 20 69 74 0a 20 20 20 20 contains it.
2130: 61 72 65 20 62 6f 74 68 20 72 65 61 64 61 62 6c are both readabl
2140: 65 20 61 6e 64 20 77 72 69 74 61 62 6c 65 20 62 e and writable b
2150: 79 20 74 68 65 20 75 73 65 72 20 74 68 61 74 20 y the user that
2160: 43 47 49 20 73 63 72 69 70 74 73 20 72 75 6e 20 CGI scripts run
2170: 61 73 2e 0a 20 20 20 20 54 68 65 6e 20 70 6f 69 as.. Then poi
2180: 6e 74 20 63 6c 69 65 6e 74 73 20 61 74 20 74 68 nt clients at th
2190: 65 20 43 47 49 20 73 63 72 69 70 74 2e 20 20 54 e CGI script. T
21a0: 68 61 74 27 73 20 61 6c 6c 20 74 68 65 72 65 20 hat's all there
21b0: 69 73 20 74 6f 20 69 74 21 3c 2f 70 3e 0a 0a 20 is to it!</p>..
21c0: 20 20 20 3c 61 20 6e 61 6d 65 3d 22 69 6e 65 74 <a name="inet
21d0: 64 73 65 72 76 65 72 22 3e 3c 2f 61 3e 0a 20 20 dserver"></a>.
21e0: 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c 73 <p>You can als
21f0: 6f 20 72 75 6e 20 66 6f 73 73 69 6c 20 6f 66 66 o run fossil off
2200: 20 6f 66 20 69 6e 65 74 64 20 6f 72 20 78 69 6e of inetd or xin
2210: 65 74 64 2e 20 20 46 6f 72 20 61 6e 20 69 6e 65 etd. For an ine
2220: 74 64 0a 20 20 20 20 69 6e 73 74 61 6c 6c 61 74 td. installat
2230: 69 6f 6e 2c 20 6d 61 6b 65 20 61 6e 20 65 6e 74 ion, make an ent
2240: 72 79 20 69 6e 20 2f 65 74 63 2f 69 6e 65 74 64 ry in /etc/inetd
2250: 2e 63 6f 6e 66 20 74 68 61 74 20 6c 6f 6f 6b 73 .conf that looks
2260: 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 6c something. l
2270: 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 0a 20 ike this:</p>..
2280: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote><
2290: 62 3e 0a 20 20 20 20 38 30 20 73 74 72 65 61 6d b>. 80 stream
22a0: 20 74 63 70 20 6e 6f 77 61 69 74 2e 31 30 30 30 tcp nowait.1000
22b0: 20 72 6f 6f 74 20 2f 75 73 72 2f 62 69 6e 2f 66 root /usr/bin/f
22c0: 6f 73 73 69 6c 20 5c 3c 62 72 3e 0a 20 20 20 20 ossil \<br>.
22d0: 20 20 20 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 /usr/bin/fos
22e0: 73 69 6c 20 68 74 74 70 20 2f 68 6f 6d 65 2f 70 sil http /home/p
22f0: 72 6f 6a 31 2f 72 65 70 6f 73 31 2e 66 6f 73 73 roj1/repos1.foss
2300: 69 6c 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f il. </b></blo
2310: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2320: 3e 41 64 6a 75 73 74 20 74 68 65 20 70 61 74 68 >Adjust the path
2330: 73 20 74 6f 20 73 75 69 74 20 79 6f 75 72 20 69 s to suit your i
2340: 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 6f 66 20 nstallation, of
2350: 63 6f 75 72 73 65 2e 20 20 4e 6f 74 69 63 65 20 course. Notice
2360: 74 68 61 74 0a 20 20 20 20 66 6f 73 73 69 6c 20 that. fossil
2370: 72 75 6e 73 20 61 73 20 72 6f 6f 74 2e 20 20 54 runs as root. T
2380: 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71 75 69 his is not requi
2390: 72 65 64 20 2d 20 79 6f 75 20 63 61 6e 20 72 75 red - you can ru
23a0: 6e 20 69 74 20 61 73 20 61 6e 0a 20 20 20 20 75 n it as an. u
23b0: 6e 70 72 69 76 69 6c 65 67 65 64 20 75 73 65 72 nprivileged user
23c0: 2e 20 20 42 75 74 20 69 74 20 69 73 20 6d 6f 72 . But it is mor
23d0: 65 20 73 65 63 75 72 65 20 74 6f 20 72 75 6e 20 e secure to run
23e0: 66 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2e 0a fossil as root..
23f0: 20 20 20 20 57 68 65 6e 20 79 6f 75 20 64 6f 20 When you do
2400: 72 75 6e 20 66 6f 73 73 69 6c 20 61 73 20 72 6f run fossil as ro
2410: 6f 74 2c 20 69 74 20 61 75 74 6f 6d 61 74 69 63 ot, it automatic
2420: 61 6c 6c 79 20 70 75 74 73 20 69 74 73 65 6c 66 ally puts itself
2430: 20 69 6e 20 61 0a 20 20 20 20 63 68 72 6f 6f 74 in a. chroot
2440: 20 6a 61 69 6c 20 69 6e 20 74 68 65 20 73 61 6d jail in the sam
2450: 65 20 64 69 72 65 63 74 6f 72 79 20 61 73 20 74 e directory as t
2460: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 74 he repository, t
2470: 68 65 6e 20 64 72 6f 70 73 0a 20 20 20 20 72 6f hen drops. ro
2480: 6f 74 20 70 72 69 76 69 6c 65 67 65 73 20 70 72 ot privileges pr
2490: 69 6f 72 20 74 6f 20 72 65 61 64 69 6e 67 20 61 ior to reading a
24a0: 6e 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 ny information f
24b0: 72 6f 6d 20 74 68 65 20 72 65 71 75 65 73 74 2e rom the request.
24c0: 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </p>..</blockquo
24d0: 74 65 3e 3c 61 20 6e 61 6d 65 3d 22 70 72 6f 78 te><a name="prox
24e0: 79 22 3e 3c 2f 61 3e 3c 68 32 3e 48 54 54 50 20 y"></a><h2>HTTP
24f0: 50 72 6f 78 69 65 73 3c 2f 68 32 3e 3c 62 6c 6f Proxies</h2><blo
2500: 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 ckquote>.. <p
2510: 3e 49 66 20 79 6f 75 20 61 72 65 20 62 65 68 69 >If you are behi
2520: 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 76 65 nd a restrictive
2530: 20 66 69 72 65 77 61 6c 6c 20 74 68 61 74 20 72 firewall that r
2540: 65 71 75 69 72 65 73 20 79 6f 75 20 74 6f 20 75 equires you to u
2550: 73 65 0a 20 20 20 20 61 6e 20 48 54 54 50 20 70 se. an HTTP p
2560: 72 6f 78 79 20 74 6f 20 72 65 61 63 68 20 74 68 roxy to reach th
2570: 65 20 69 6e 74 65 72 6e 65 74 2c 20 74 68 65 6e e internet, then
2580: 20 79 6f 75 20 63 61 6e 20 63 6f 6e 66 69 67 75 you can configu
2590: 72 65 20 74 68 65 20 70 72 6f 78 79 0a 20 20 20 re the proxy.
25a0: 20 69 6e 20 74 68 72 65 65 20 64 69 66 66 65 72 in three differ
25b0: 65 6e 74 20 77 61 79 73 2e 20 20 59 6f 75 20 63 ent ways. You c
25c0: 61 6e 20 74 65 6c 6c 20 66 6f 73 73 69 6c 20 61 an tell fossil a
25d0: 62 6f 75 74 20 79 6f 75 72 20 70 72 6f 78 79 20 bout your proxy
25e0: 75 73 69 6e 67 0a 20 20 20 20 61 20 63 6f 6d 6d using. a comm
25f0: 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 and-line option
2600: 6f 6e 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 on commands that
2610: 20 75 73 65 20 74 68 65 20 6e 65 74 77 6f 72 6b use the network
2620: 2c 0a 20 20 20 20 3c 62 3e 73 79 6e 63 3c 2f 62 ,. <b>sync</b
2630: 3e 2c 20 3c 62 3e 63 6c 6f 6e 65 3c 2f 62 3e 2c >, <b>clone</b>,
2640: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2c 20 61 6e <b>push</b>, an
2650: 64 20 3c 62 3e 70 75 6c 6c 3c 2f 62 3e 2e 3c 2f d <b>pull</b>.</
2660: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu
2670: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss
2680: 69 6c 20 63 6c 6f 6e 65 20 3c 2f 62 3e 3c 69 3e il clone </b><i>
2690: 55 52 4c 3c 2f 69 3e 20 20 3c 62 3e 2d 2d 70 72 URL</i> <b>--pr
26a0: 6f 78 79 3c 2f 62 3e 20 3c 69 3e 50 72 6f 78 79 oxy</b> <i>Proxy
26b0: 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 -URL</i>. </b
26c0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
26d0: 3c 70 3e 49 74 20 69 73 20 61 6e 6e 6f 79 69 6e <p>It is annoyin
26e0: 67 20 74 6f 20 68 61 76 65 20 74 6f 20 74 79 70 g to have to typ
26f0: 65 20 69 6e 20 74 68 65 20 70 72 6f 78 79 20 55 e in the proxy U
2700: 52 4c 20 65 76 65 72 79 20 74 69 6d 65 20 79 6f RL every time yo
2710: 75 0a 20 20 20 20 73 79 6e 63 20 79 6f 75 72 20 u. sync your
2720: 70 72 6f 6a 65 63 74 2c 20 74 68 6f 75 67 68 2c project, though,
2730: 20 73 6f 20 79 6f 75 20 63 61 6e 20 6d 61 6b 65 so you can make
2740: 20 74 68 65 20 70 72 6f 78 79 20 63 6f 6e 66 69 the proxy confi
2750: 67 75 72 61 74 69 6f 6e 0a 20 20 20 20 70 65 72 guration. per
2760: 73 69 73 74 65 6e 74 20 75 73 69 6e 67 20 74 68 sistent using th
2770: 65 20 3c 62 3e 73 65 74 74 69 6e 67 3c 2f 62 3e e <b>setting</b>
2780: 20 63 6f 6d 6d 61 6e 64 3a 3c 2f 70 3e 0a 0a 20 command:</p>..
2790: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
27a0: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 65 <b>fossil se
27b0: 74 74 69 6e 67 20 70 72 6f 78 79 20 3c 2f 62 3e tting proxy </b>
27c0: 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e <i>Proxy-URL</i>
27d0: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
27e0: 65 3e 0a 0a 20 20 20 20 3c 70 3e 4f 72 2c 20 79 e>.. <p>Or, y
27f0: 6f 75 20 63 61 6e 20 73 65 74 20 74 68 65 20 22 ou can set the "
2800: 3c 62 3e 68 74 74 70 5f 70 72 6f 78 79 3c 2f 62 <b>http_proxy</b
2810: 3e 22 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 >" environment v
2820: 61 72 69 61 62 6c 65 3a 3c 2f 70 3e 0a 0a 20 20 ariable:</p>..
2830: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
2840: 20 20 20 3c 62 3e 65 78 70 6f 72 74 20 68 74 74 <b>export htt
2850: 70 5f 70 72 6f 78 79 3d 3c 2f 62 3e 3c 69 3e 50 p_proxy=</b><i>P
2860: 72 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 roxy-URL</i>.
2870: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>..
2880: 20 20 20 20 3c 70 3e 54 6f 20 73 74 6f 70 20 75 <p>To stop u
2890: 73 69 6e 67 20 74 68 65 20 70 72 6f 78 79 2c 20 sing the proxy,
28a0: 64 6f 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c do:</p>.. <bl
28b0: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
28c0: 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 >fossil setting
28d0: 70 72 6f 78 79 20 6f 66 66 3c 2f 62 3e 0a 20 20 proxy off</b>.
28e0: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
28f0: 0a 20 20 20 20 3c 70 3e 4f 72 20 75 6e 73 65 74 . <p>Or unset
2900: 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 the environment
2910: 20 76 61 72 69 61 62 6c 65 2e 20 20 54 68 65 20 variable. The
2920: 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 20 66 fossil setting f
2930: 6f 72 20 74 68 65 0a 20 20 20 20 48 54 54 50 20 or the. HTTP
2940: 70 72 6f 78 79 20 74 61 6b 65 73 20 70 72 65 63 proxy takes prec
2950: 65 64 65 6e 63 65 20 6f 76 65 72 20 74 68 65 20 edence over the
2960: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari
2970: 61 62 6c 65 20 61 6e 64 20 74 68 65 0a 20 20 20 able and the.
2980: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 command-line op
2990: 74 69 6f 6e 20 6f 76 65 72 72 69 64 65 73 20 62 tion overrides b
29a0: 6f 74 68 2e 20 20 49 66 20 79 6f 75 20 68 61 76 oth. If you hav
29b0: 65 20 61 6e 20 70 65 72 73 69 73 74 65 6e 74 0a e an persistent.
29c0: 20 20 20 20 70 72 6f 78 79 20 73 65 74 74 69 6e proxy settin
29d0: 67 20 74 68 61 74 20 79 6f 75 20 77 61 6e 74 20 g that you want
29e0: 74 6f 20 6f 76 65 72 72 69 64 65 20 66 6f 72 20 to override for
29f0: 61 20 6f 6e 65 2d 74 69 6d 65 20 73 79 6e 63 2c a one-time sync,
2a00: 20 74 68 61 74 0a 20 20 20 20 69 73 20 65 61 73 that. is eas
2a10: 69 6c 79 20 64 6f 6e 65 20 6f 6e 20 74 68 65 20 ily done on the
2a20: 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 20 20 46 command-line. F
2a30: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 73 or example, to s
2a40: 79 6e 63 20 77 69 74 68 0a 20 20 20 20 61 20 63 ync with. a c
2a50: 6f 2d 77 6f 72 6b 65 72 73 20 72 65 70 6f 73 69 o-workers reposi
2a60: 74 6f 72 79 20 6f 6e 20 79 6f 75 72 20 4c 41 4e tory on your LAN
2a70: 2c 20 79 6f 75 20 6d 69 67 68 74 20 74 79 70 65 , you might type
2a80: 3a 3c 2f 70 3e 20 20 20 0a 0a 20 20 20 20 3c 62 :</p> .. <b
2a90: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
2aa0: 62 3e 66 6f 73 73 69 6c 20 73 79 6e 63 20 68 74 b>fossil sync ht
2ab0: 74 70 3a 2f 2f 31 39 32 2e 31 36 38 2e 31 2e 33 tp://192.168.1.3
2ac0: 36 3a 38 30 38 30 2f 20 2d 2d 70 72 6f 78 79 20 6:8080/ --proxy
2ad0: 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c off</b>. </bl
2ae0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f ockquote>..</blo
2af0: 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 4d 6f 72 65 ckquote><h2>More
2b00: 20 48 69 6e 74 73 3c 2f 68 32 3e 3c 62 6c 6f 63 Hints</h2><bloc
2b10: 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e kquote>.. <p>
2b20: 54 72 79 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e Try these comman
2b30: 64 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c ds:</p>.. <bl
2b40: 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 20 ockquote><b>.
2b50: 20 66 6f 73 73 69 6c 20 68 65 6c 70 3c 62 72 3e fossil help<br>
2b60: 0a 20 20 20 20 66 6f 73 73 69 6c 20 74 65 73 74 . fossil test
2b70: 2d 63 6f 6d 6d 61 6e 64 73 0a 20 20 20 20 3c 2f -commands. </
2b80: 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a b></blockquote>.
2b90: 0a 20 20 20 20 3c 70 3e 45 78 70 6c 6f 72 65 20 . <p>Explore
2ba0: 61 6e 64 20 68 61 76 65 20 66 75 6e 21 3c 2f 70 and have fun!</p
2bb0: 3e 0a 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 >...</blockquote
2bc0: 3e 0a 3c 2f 6e 6f 77 69 6b 69 3e 0a >.</nowiki>.