0000: 3c 6e 6f 77 69 6b 69 3e 0a 3c 68 31 20 61 6c 69 <nowiki>.<h1 ali
0010: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 46 6f 73 73 gn="center">Foss
0020: 69 6c 20 51 75 69 63 6b 20 53 74 61 72 74 3c 2f il Quick Start</
0030: 68 31 3e 0a 0a 3c 70 3e 54 68 69 73 20 69 73 20 h1>..<p>This is
0040: 61 20 67 75 69 64 65 20 74 6f 20 67 65 74 20 79 a guide to get y
0050: 6f 75 20 73 74 61 72 74 65 64 20 75 73 69 6e 67 ou started using
0060: 20 66 6f 73 73 69 6c 20 71 75 69 63 6b 6c 79 0a fossil quickly.
0070: 61 6e 64 20 70 61 69 6e 6c 65 73 73 6c 79 2e 3c and painlessly.<
0080: 2f 70 3e 0a 0a 3c 68 32 3e 49 6e 73 74 61 6c 6c /p>..<h2>Install
0090: 69 6e 67 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ing</h2><blockqu
00a0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 46 6f 73 ote>.. <p>Fos
00b0: 73 69 6c 20 69 73 20 61 20 73 69 6e 67 6c 65 20 sil is a single
00c0: 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 20 43 self-contained C
00d0: 20 70 72 6f 67 72 61 6d 2e 20 20 59 6f 75 20 6e program. You n
00e0: 65 65 64 20 74 6f 0a 20 20 20 20 65 69 74 68 65 eed to. eithe
00f0: 72 20 64 6f 77 6e 6c 6f 61 64 20 61 20 0a 20 20 r download a .
0100: 20 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 3a <a href="http:
0110: 2f 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d //www.fossil-scm
0120: 2e 6f 72 67 2f 64 6f 77 6e 6c 6f 61 64 2e 68 74 .org/download.ht
0130: 6d 6c 22 3e 70 72 65 63 6f 6d 70 69 6c 65 64 20 ml">precompiled
0140: 62 69 6e 61 72 79 3c 2f 61 3e 0a 20 20 20 20 6f binary</a>. o
0150: 72 20 3c 61 20 68 72 65 66 3d 22 62 75 69 6c 64 r <a href="build
0160: 2e 77 69 6b 69 22 3e 62 75 69 6c 64 20 69 74 20 .wiki">build it
0170: 79 6f 75 72 73 65 6c 66 3c 2f 61 3e 20 66 72 6f yourself</a> fro
0180: 6d 20 73 6f 75 72 63 65 73 2e 0a 20 20 20 20 49 m sources.. I
0190: 6e 73 74 61 6c 6c 20 66 6f 73 73 69 6c 20 62 79 nstall fossil by
01a0: 20 70 75 74 74 69 6e 67 20 74 68 65 20 66 6f 73 putting the fos
01b0: 73 69 6c 20 62 69 6e 61 72 79 0a 20 20 20 20 73 sil binary. s
01c0: 6f 6d 65 70 6c 61 63 65 20 6f 6e 20 79 6f 75 72 omeplace on your
01d0: 20 50 41 54 48 20 65 6e 76 69 72 6f 6e 6d 65 6e PATH environmen
01e0: 74 20 76 61 72 69 61 62 6c 65 2e 3c 2f 70 3e 0a t variable.</p>.
01f0: 20 20 20 20 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b . </block
0200: 71 75 6f 74 65 3e 0a 20 20 20 20 3c 61 20 6e 61 quote>. <a na
0210: 6d 65 3d 22 23 66 73 6c 63 6c 6f 6e 65 22 3e 3c me="#fslclone"><
0220: 68 32 3e 43 6c 6f 6e 69 6e 67 20 41 6e 20 45 78 h2>Cloning An Ex
0230: 69 73 74 69 6e 67 20 52 65 70 6f 73 69 74 6f 72 isting Repositor
0240: 79 3c 2f 68 32 3e 3c 2f 61 3e 0a 20 20 20 20 3c y</h2></a>. <
0250: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
0260: 20 3c 70 3e 4d 6f 73 74 20 66 6f 73 73 69 6c 20 <p>Most fossil
0270: 6f 70 65 72 61 74 69 6f 6e 73 20 69 6e 74 65 72 operations inter
0280: 61 63 74 20 77 69 74 68 20 61 20 72 65 70 6f 73 act with a repos
0290: 69 74 6f 72 79 20 74 68 61 74 20 69 73 20 6f 6e itory that is on
02a0: 20 74 68 65 0a 20 20 20 20 6c 6f 63 61 6c 20 64 the. local d
02b0: 69 73 6b 20 64 72 69 76 65 2c 20 6e 6f 74 20 6f isk drive, not o
02c0: 6e 20 61 20 72 65 6d 6f 74 65 20 73 79 73 74 65 n a remote syste
02d0: 6d 2e 20 20 48 65 6e 63 65 2c 20 62 65 66 6f 72 m. Hence, befor
02e0: 65 20 61 63 63 65 73 73 69 6e 67 0a 20 20 20 20 e accessing.
02f0: 61 20 72 65 6d 6f 74 65 20 72 65 70 6f 73 69 74 a remote reposit
0300: 6f 72 79 20 69 74 20 69 73 20 6e 65 63 65 73 73 ory it is necess
0310: 61 72 79 20 74 6f 20 6d 61 6b 65 20 61 20 6c 6f ary to make a lo
0320: 63 61 6c 20 63 6f 70 79 20 6f 66 20 74 68 61 74 cal copy of that
0330: 0a 20 20 20 20 72 65 70 6f 73 69 74 6f 72 79 2e . repository.
0340: 20 20 4d 61 6b 69 6e 67 20 61 20 6c 6f 63 61 6c Making a local
0350: 20 63 6f 70 79 20 6f 66 20 61 20 72 65 6d 6f 74 copy of a remot
0360: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 20 e repository is
0370: 63 61 6c 6c 65 64 0a 20 20 20 20 22 63 6c 6f 6e called. "clon
0380: 69 6e 67 22 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 ing".</p>. .
0390: 20 20 20 3c 70 3e 43 6c 6f 6e 65 20 61 20 72 65 <p>Clone a re
03a0: 6d 6f 74 65 20 72 65 70 6f 73 69 74 6f 72 79 20 mote repository
03b0: 61 73 20 66 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a as follows:</p>.
03c0: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 . <blockq
03d0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
03e0: 73 69 6c 20 63 6c 6f 6e 65 3c 2f 62 3e 20 3c 69 sil clone</b> <i
03f0: 3e 55 52 4c 20 20 72 65 70 6f 73 69 74 6f 72 79 >URL repository
0400: 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 -filename</i>.
0410: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
0420: 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 68 65 20 . <p>The
0430: 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 62 6f 76 65 <i>URL</i> above
0440: 20 69 73 20 74 68 65 20 68 74 74 70 20 55 52 4c is the http URL
0450: 20 66 6f 72 20 74 68 65 20 66 6f 73 73 69 6c 20 for the fossil
0460: 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 20 20 79 repository. y
0470: 6f 75 20 77 61 6e 74 20 74 6f 20 63 6c 6f 6e 65 ou want to clone
0480: 2c 20 61 6e 64 20 69 74 20 6d 61 79 20 69 6e 63 , and it may inc
0490: 6c 75 64 65 20 61 20 22 75 73 65 72 3a 70 61 73 lude a "user:pas
04a0: 73 77 6f 72 64 22 20 70 61 72 74 2c 20 65 2e 67 sword" part, e.g
04b0: 2e 0a 20 20 20 20 3c 74 74 3e 68 74 74 70 3a 2f .. <tt>http:/
04c0: 2f 64 72 68 3a 73 65 63 72 65 74 40 77 77 77 2e /drh:secret@www.
04d0: 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 66 fossil-scm.org/f
04e0: 6f 73 73 69 6c 3c 2f 74 74 3e 2e 20 59 6f 75 20 ossil</tt>. You
04f0: 63 61 6e 0a 20 20 20 20 63 61 6c 6c 20 74 68 65 can. call the
0500: 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79 20 new repository
0510: 61 6e 79 74 68 69 6e 67 20 79 6f 75 20 77 61 6e anything you wan
0520: 74 20 2d 20 74 68 65 72 65 20 61 72 65 20 6e 6f t - there are no
0530: 20 6e 61 6d 69 6e 67 0a 20 20 20 20 72 65 73 74 naming. rest
0540: 72 69 63 74 69 6f 6e 73 2e 20 20 41 73 20 61 6e rictions. As an
0550: 20 65 78 61 6d 70 6c 65 2c 20 79 6f 75 20 63 61 example, you ca
0560: 6e 20 63 6c 6f 6e 65 20 74 68 65 20 66 6f 73 73 n clone the foss
0570: 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 il repository.
0580: 20 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 3e 0a this way:</p>.
0590: 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 . <blockq
05a0: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
05b0: 73 69 6c 20 63 6c 6f 6e 65 20 68 74 74 70 3a 2f sil clone http:/
05c0: 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e /www.fossil-scm.
05d0: 6f 72 67 2f 20 6d 79 63 6c 6f 6e 65 2e 66 6f 73 org/ myclone.fos
05e0: 73 69 6c 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 6c sil</b>. </bl
05f0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
0600: 70 3e 54 68 65 20 6e 65 77 20 6c 6f 63 61 6c 20 p>The new local
0610: 63 6f 70 79 20 6f 66 20 74 68 65 20 72 65 73 70 copy of the resp
0620: 6f 73 69 74 6f 72 79 20 69 73 20 73 74 6f 72 65 ository is store
0630: 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 66 69 d in a single fi
0640: 6c 65 2c 0a 20 20 20 20 77 68 69 63 68 20 69 6e le,. which in
0650: 20 74 68 65 20 65 78 61 6d 70 6c 65 20 61 62 6f the example abo
0660: 76 65 20 69 73 20 6e 61 6d 65 64 20 22 6d 79 63 ve is named "myc
0670: 6c 6f 6e 65 2e 66 6f 73 73 69 6c 22 2e 0a 20 20 lone.fossil"..
0680: 20 20 59 6f 75 20 63 61 6e 20 6e 61 6d 65 20 79 You can name y
0690: 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 our repositories
06a0: 20 61 6e 79 74 68 69 6e 67 20 79 6f 75 20 77 61 anything you wa
06b0: 6e 74 2e 20 20 54 68 65 20 22 2e 66 6f 73 73 69 nt. The ".fossi
06c0: 6c 22 20 73 75 66 66 69 78 0a 20 20 20 20 69 73 l" suffix. is
06d0: 20 6e 6f 74 20 72 65 71 75 69 72 65 64 2e 3c 2f not required.</
06e0: 70 3e 0a 0a 20 20 20 20 3c 70 3e 4e 6f 74 65 3a p>.. <p>Note:
06f0: 20 49 66 20 79 6f 75 20 61 72 65 20 62 65 68 69 If you are behi
0700: 6e 64 20 61 20 72 65 73 74 72 69 63 74 69 76 65 nd a restrictive
0710: 20 66 69 72 65 77 61 6c 6c 2c 20 79 6f 75 20 6d firewall, you m
0720: 69 67 68 74 20 6e 65 65 64 0a 20 20 20 20 74 6f ight need. to
0730: 20 3c 61 20 68 72 65 66 3d 22 23 70 72 6f 78 79 <a href="#proxy
0740: 22 3e 73 70 65 63 69 66 79 20 61 6e 20 48 54 54 ">specify an HTT
0750: 50 20 70 72 6f 78 79 3c 2f 61 3e 20 74 6f 20 75 P proxy</a> to u
0760: 73 65 2e 3c 2f 70 3e 0a 20 20 20 20 0a 3c 2f 62 se.</p>. .</b
0770: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 74 lockquote><h2>St
0780: 61 72 74 69 6e 67 20 41 20 4e 65 77 20 50 72 6f arting A New Pro
0790: 6a 65 63 74 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 ject</h2><blockq
07a0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f uote>.. <p>To
07b0: 20 73 74 61 72 74 20 61 20 6e 65 77 20 70 72 6f start a new pro
07c0: 6a 65 63 74 20 77 69 74 68 20 66 6f 73 73 69 6c ject with fossil
07d0: 2c 20 63 72 65 61 74 65 20 61 20 6e 65 77 20 65 , create a new e
07e0: 6d 70 74 79 20 72 65 70 6f 73 69 74 6f 72 79 0a mpty repository.
07f0: 20 20 20 20 74 68 69 73 20 77 61 79 3a 3c 2f 70 this way:</p
0800: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 >. . <bloc
0810: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
0820: 6f 73 73 69 6c 20 6e 65 77 20 3c 2f 62 3e 3c 69 ossil new </b><i
0830: 3e 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c > repository-fil
0840: 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f ename</i>. </
0850: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 blockquote>.
0860: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h
0870: 32 3e 43 6f 6e 66 69 67 75 72 69 6e 67 20 59 6f 2>Configuring Yo
0880: 75 72 20 4c 6f 63 61 6c 20 52 65 70 6f 73 69 74 ur Local Reposit
0890: 6f 72 79 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 ory</h2><blockqu
08a0: 6f 74 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 ote>. . <p
08b0: 3e 57 68 65 6e 20 79 6f 75 20 63 72 65 61 74 65 >When you create
08c0: 20 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 a new repositor
08d0: 79 2c 20 65 69 74 68 65 72 20 62 79 20 63 6c 6f y, either by clo
08e0: 6e 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 ning an existing
08f0: 0a 20 20 20 20 70 72 6f 6a 65 63 74 20 6f 72 20 . project or
0900: 63 72 65 61 74 65 20 61 20 6e 65 77 20 70 72 6f create a new pro
0910: 6a 65 63 74 20 6f 66 20 79 6f 75 72 20 6f 77 6e ject of your own
0920: 2c 20 79 6f 75 20 75 73 75 61 6c 6c 79 20 77 61 , you usually wa
0930: 6e 74 20 74 6f 20 64 6f 20 73 6f 6d 65 0a 20 20 nt to do some.
0940: 20 20 6c 6f 63 61 6c 20 63 6f 6e 66 69 67 75 72 local configur
0950: 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 ation. This is
0960: 65 61 73 69 6c 79 20 61 63 63 6f 6d 70 6c 69 73 easily accomplis
0970: 68 65 64 20 75 73 69 6e 67 20 74 68 65 20 77 65 hed using the we
0980: 62 73 65 72 76 65 72 0a 20 20 20 20 74 68 61 74 bserver. that
0990: 20 69 73 20 62 75 69 6c 74 20 69 6e 74 6f 20 66 is built into f
09a0: 6f 73 73 69 6c 2e 20 20 53 74 61 72 74 20 74 68 ossil. Start th
09b0: 65 20 66 6f 73 73 69 6c 20 77 65 62 73 65 72 76 e fossil webserv
09c0: 65 72 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 er like this:</p
09d0: 3e 0a 20 20 20 20 0a 20 20 20 20 3c 62 6c 6f 63 >. . <bloc
09e0: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 kquote>. <b>f
09f0: 6f 73 73 69 6c 20 75 69 20 3c 2f 62 3e 3c 69 3e ossil ui </b><i>
0a00: 20 72 65 70 6f 73 69 74 6f 72 79 2d 66 69 6c 65 repository-file
0a10: 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 name</i>. </b
0a20: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
0a30: 3c 70 3e 54 68 69 73 20 73 74 61 72 74 73 20 61 <p>This starts a
0a40: 20 77 65 62 73 65 72 76 65 72 20 6c 69 73 74 65 webserver liste
0a50: 6e 69 6e 67 20 6f 6e 20 70 6f 72 74 20 38 30 38 ning on port 808
0a60: 30 2e 20 20 59 6f 75 20 63 61 6e 0a 20 20 20 20 0. You can.
0a70: 73 70 65 63 69 66 79 20 61 20 64 69 66 66 65 72 specify a differ
0a80: 65 6e 74 20 70 6f 72 74 20 75 73 69 6e 67 20 74 ent port using t
0a90: 68 65 20 3c 62 3e 2d 70 6f 72 74 3c 2f 62 3e 20 he <b>-port</b>
0aa0: 6f 70 74 69 6f 6e 20 6f 6e 20 74 68 65 20 63 6f option on the co
0ab0: 6d 6d 61 6e 64 2d 6c 69 6e 65 2e 0a 20 20 20 20 mmand-line..
0ac0: 41 66 74 65 72 20 74 68 65 20 73 65 72 76 65 72 After the server
0ad0: 20 69 73 20 72 75 6e 6e 69 6e 67 2c 20 66 6f 73 is running, fos
0ae0: 73 69 6c 20 77 69 6c 6c 20 74 68 65 6e 20 61 74 sil will then at
0af0: 74 65 6d 70 74 20 74 6f 20 6c 61 75 6e 63 68 20 tempt to launch
0b00: 79 6f 75 72 0a 20 20 20 20 77 65 62 20 62 72 6f your. web bro
0b10: 77 73 65 72 20 61 6e 64 20 6d 61 6b 65 20 69 74 wser and make it
0b20: 20 70 6f 69 6e 74 20 74 6f 20 74 68 69 73 20 77 point to this w
0b30: 65 62 20 73 65 72 76 65 72 2e 20 20 49 66 20 79 eb server. If y
0b40: 6f 75 72 20 73 79 73 74 65 6d 0a 20 20 20 20 68 our system. h
0b50: 61 73 20 61 6e 20 75 6e 75 73 75 61 6c 20 63 6f as an unusual co
0b60: 6e 66 69 67 75 72 61 74 69 6f 6e 2c 20 66 6f 73 nfiguration, fos
0b70: 73 69 6c 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 sil might not be
0b80: 20 61 62 6c 65 20 74 6f 20 66 69 67 75 72 65 20 able to figure
0b90: 6f 75 74 0a 20 20 20 20 68 6f 77 20 74 6f 20 73 out. how to s
0ba0: 74 61 72 74 20 79 6f 75 72 20 77 65 62 20 62 72 tart your web br
0bb0: 6f 77 73 65 72 2e 20 20 49 6e 20 74 68 61 74 20 owser. In that
0bc0: 63 61 73 65 2c 20 73 74 61 72 74 20 74 68 65 20 case, start the
0bd0: 77 65 62 20 62 72 6f 77 73 65 72 0a 20 20 20 20 web browser.
0be0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 70 6f 69 yourself and poi
0bf0: 6e 74 20 69 74 20 61 74 20 68 74 74 70 3a 2f 2f nt it at http://
0c00: 6c 6f 63 61 6c 68 6f 73 74 3a 38 30 38 30 2f 2e localhost:8080/.
0c10: 20 20 43 6c 69 63 6b 20 6f 6e 20 74 68 65 0a 20 Click on the.
0c20: 20 20 20 22 41 64 6d 69 6e 22 20 6c 69 6e 6b 20 "Admin" link
0c30: 6f 6e 20 74 68 65 20 6d 65 6e 75 20 62 61 72 20 on the menu bar
0c40: 74 6f 20 73 74 61 72 74 20 63 6f 6e 66 69 67 75 to start configu
0c50: 72 69 6e 67 20 79 6f 75 72 20 72 65 70 6f 73 69 ring your reposi
0c60: 74 6f 72 79 2e 3c 2f 70 3e 0a 20 20 20 20 0a 20 tory.</p>. .
0c70: 20 20 20 3c 70 3e 42 79 20 64 65 66 61 75 6c 74 <p>By default
0c80: 2c 20 66 6f 73 73 69 6c 20 64 6f 65 73 20 6e 6f , fossil does no
0c90: 74 20 72 65 71 75 69 72 65 20 61 20 6c 6f 67 69 t require a logi
0ca0: 6e 20 66 6f 72 20 48 54 54 50 20 63 6f 6e 6e 65 n for HTTP conne
0cb0: 63 74 69 6f 6e 73 0a 20 20 20 20 63 6f 6d 69 6e ctions. comin
0cc0: 67 20 69 6e 20 66 72 6f 6d 20 74 68 65 20 49 50 g in from the IP
0cd0: 20 6c 6f 6f 70 62 61 63 6b 20 61 64 64 72 65 73 loopback addres
0ce0: 73 20 31 32 37 2e 30 2e 30 2e 31 2e 20 20 59 6f s 127.0.0.1. Yo
0cf0: 75 20 63 61 6e 2c 20 61 6e 64 20 70 65 72 68 61 u can, and perha
0d00: 70 73 0a 20 20 20 20 73 68 6f 75 6c 64 2c 20 63 ps. should, c
0d10: 68 61 6e 67 65 20 74 68 69 73 20 61 66 74 65 72 hange this after
0d20: 20 79 6f 75 20 63 72 65 61 74 65 20 61 20 66 65 you create a fe
0d30: 77 20 75 73 65 72 73 2e 3c 2f 70 3e 0a 20 20 20 w users.</p>.
0d40: 20 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79 6f . <p>When yo
0d50: 75 20 61 72 65 20 66 69 6e 69 73 68 65 64 20 63 u are finished c
0d60: 6f 6e 66 69 67 75 72 69 6e 67 2c 20 6a 75 73 74 onfiguring, just
0d70: 20 70 72 65 73 73 20 43 6f 6e 74 72 6f 6c 2d 43 press Control-C
0d80: 20 6f 72 20 75 73 65 0a 20 20 20 20 74 68 65 20 or use. the
0d90: 3c 62 3e 6b 69 6c 6c 3c 2f 62 3e 20 63 6f 6d 6d <b>kill</b> comm
0da0: 61 6e 64 20 74 6f 20 73 68 75 74 20 64 6f 77 6e and to shut down
0db0: 20 74 68 65 20 6d 69 6e 69 2d 73 65 72 76 65 72 the mini-server
0dc0: 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 .</p>..</blockqu
0dd0: 6f 74 65 3e 3c 68 32 3e 43 68 65 63 6b 69 6e 67 ote><h2>Checking
0de0: 20 4f 75 74 20 41 20 4c 6f 63 61 6c 20 54 72 65 Out A Local Tre
0df0: 65 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 e</h2><blockquot
0e00: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 77 6f e>.. <p>To wo
0e10: 72 6b 20 6f 6e 20 61 20 70 72 6f 6a 65 63 74 20 rk on a project
0e20: 69 6e 20 66 6f 73 73 69 6c 2c 20 79 6f 75 20 6e in fossil, you n
0e30: 65 65 64 20 74 6f 20 63 68 65 63 6b 20 6f 75 74 eed to check out
0e40: 20 61 20 6c 6f 63 61 6c 0a 20 20 20 20 63 6f 70 a local. cop
0e50: 79 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 y of the source
0e60: 74 72 65 65 2e 20 20 43 72 65 61 74 65 20 74 68 tree. Create th
0e70: 65 20 64 69 72 65 63 74 6f 72 79 20 79 6f 75 20 e directory you
0e80: 77 61 6e 74 20 74 6f 20 62 65 0a 20 20 20 20 74 want to be. t
0e90: 68 65 20 72 6f 6f 74 20 6f 66 20 79 6f 75 72 20 he root of your
0ea0: 74 72 65 65 20 61 6e 64 20 63 64 20 69 6e 74 6f tree and cd into
0eb0: 20 74 68 61 74 20 64 69 72 65 63 74 6f 72 79 2e that directory.
0ec0: 20 20 54 68 65 6e 0a 20 20 20 20 64 6f 20 74 68 Then. do th
0ed0: 69 73 3a 3c 2f 70 3e 0a 20 20 20 20 0a 20 20 20 is:</p>. .
0ee0: 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 <blockquote>.
0ef0: 20 20 3c 62 3e 66 6f 73 73 69 6c 20 6f 70 65 6e <b>fossil open
0f00: 20 3c 2f 62 3e 3c 69 3e 20 72 65 70 6f 73 69 74 </b><i> reposit
0f10: 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e ory-filename</i>
0f20: 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 . </blockquot
0f30: 65 3e 0a 20 20 20 20 0a 20 20 20 20 3c 70 3e 54 e>. . <p>T
0f40: 68 69 73 20 6c 65 61 76 65 73 20 79 6f 75 20 77 his leaves you w
0f50: 69 74 68 20 74 68 65 20 6e 65 77 65 73 74 20 76 ith the newest v
0f60: 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 20 74 72 ersion of the tr
0f70: 65 65 0a 20 20 20 20 63 68 65 63 6b 65 64 20 6f ee. checked o
0f80: 75 74 2e 20 20 20 20 0a 20 20 20 20 46 72 6f 6d ut. . From
0f90: 20 61 6e 79 77 68 65 72 65 20 75 6e 64 65 72 6e anywhere undern
0fa0: 65 61 74 68 20 74 68 65 20 72 6f 6f 74 20 6f 66 eath the root of
0fb0: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 74 72 65 65 your local tree
0fc0: 2c 20 79 6f 75 0a 20 20 20 20 63 61 6e 20 74 79 , you. can ty
0fd0: 70 65 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 pe commands like
0fe0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 the following t
0ff0: 6f 20 66 69 6e 64 20 6f 75 74 20 74 68 65 20 73 o find out the s
1000: 74 61 74 75 73 20 6f 66 0a 20 20 20 20 79 6f 75 tatus of. you
1010: 72 20 6c 6f 63 61 6c 20 74 72 65 65 3a 3c 2f 70 r local tree:</p
1020: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
1030: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
1040: 6c 20 69 6e 66 6f 3c 2f 62 3e 3c 62 72 3e 0a 20 l info</b><br>.
1050: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 73 74 61 <b>fossil sta
1060: 74 75 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 tus</b><br>.
1070: 3c 62 3e 66 6f 73 73 69 6c 20 63 68 61 6e 67 65 <b>fossil change
1080: 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 s</b><br>. <b
1090: 3e 66 6f 73 73 69 6c 20 74 69 6d 65 6c 69 6e 65 >fossil timeline
10a0: 3c 2f 62 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e </b><br>. <b>
10b0: 66 6f 73 73 69 6c 20 6c 65 61 76 65 73 3c 2f 62 fossil leaves</b
10c0: 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 ><br>. <b>fos
10d0: 73 69 6c 20 6c 73 3c 2f 62 3e 3c 62 72 3e 0a 20 sil ls</b><br>.
10e0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 62 72 61 <b>fossil bra
10f0: 6e 63 68 65 73 3c 2f 62 3e 3c 62 72 3e 0a 20 20 nches</b><br>.
1100: 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a </blockquote>.
1110: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 .</blockquote><h
1120: 32 3e 4d 61 6b 69 6e 67 20 43 68 61 6e 67 65 73 2>Making Changes
1130: 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 65 </h2><blockquote
1140: 3e 0a 0a 20 20 20 20 3c 70 3e 54 6f 20 61 64 64 >.. <p>To add
1150: 20 6e 65 77 20 66 69 6c 65 73 20 74 6f 20 79 6f new files to yo
1160: 75 72 20 70 72 6f 6a 65 63 74 2c 20 6f 72 20 72 ur project, or r
1170: 65 6d 6f 76 65 20 6f 6c 64 20 66 69 6c 65 73 2c emove old files,
1180: 20 75 73 65 20 74 68 65 73 65 0a 20 20 20 20 63 use these. c
1190: 6f 6d 6d 61 6e 64 73 3a 3c 2f 70 3e 0a 0a 20 20 ommands:</p>..
11a0: 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 <blockquote>.
11b0: 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 61 64 64 <b>fossil add
11c0: 3c 2f 62 3e 20 3c 69 3e 66 69 6c 65 2e 2e 2e 3c </b> <i>file...<
11d0: 2f 69 3e 3c 62 72 3e 0a 20 20 20 20 3c 62 3e 66 /i><br>. <b>f
11e0: 6f 73 73 69 6c 20 72 6d 3c 2f 62 3e 20 3c 69 3e ossil rm</b> <i>
11f0: 66 69 6c 65 2e 2e 2e 3c 2f 69 3e 0a 20 20 20 20 file...</i>.
1200: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>..
1210: 20 20 20 3c 70 3e 59 6f 75 20 63 61 6e 20 61 6c <p>You can al
1220: 73 6f 20 65 64 69 74 20 66 69 6c 65 73 20 66 72 so edit files fr
1230: 65 65 6c 79 2e 20 20 4f 6e 63 65 20 79 6f 75 20 eely. Once you
1240: 61 72 65 20 72 65 61 64 79 20 74 6f 20 63 6f 6d are ready to com
1250: 6d 69 74 0a 20 20 20 20 79 6f 75 72 20 63 68 61 mit. your cha
1260: 6e 67 65 73 2c 20 74 79 70 65 3a 3c 2f 70 3e 0a nges, type:</p>.
1270: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
1280: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
1290: 63 6f 6d 6d 69 74 3c 2f 62 3e 0a 20 20 20 20 3c commit</b>. <
12a0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 /blockquote>..
12b0: 20 20 3c 70 3e 59 6f 75 20 77 69 6c 6c 20 62 65 <p>You will be
12c0: 20 70 72 6f 6d 70 74 65 64 20 66 6f 72 20 63 68 prompted for ch
12d0: 65 63 6b 2d 69 6e 20 63 6f 6d 6d 65 6e 74 73 20 eck-in comments
12e0: 75 73 69 6e 67 20 77 68 61 74 65 76 65 72 20 65 using whatever e
12f0: 64 69 74 6f 72 0a 20 20 20 20 69 73 20 73 70 65 ditor. is spe
1300: 63 69 66 69 65 64 20 62 79 20 79 6f 75 72 20 56 cified by your V
1310: 49 53 55 41 4c 20 6f 72 20 45 44 49 54 4f 52 20 ISUAL or EDITOR
1320: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari
1330: 61 62 6c 65 2e 20 20 49 66 20 79 6f 75 0a 20 20 able. If you.
1340: 20 20 68 61 76 65 20 47 50 47 20 69 6e 73 74 61 have GPG insta
1350: 6c 6c 65 64 2c 20 79 6f 75 20 6d 61 79 20 62 65 lled, you may be
1360: 20 70 72 6f 6d 70 74 65 64 20 66 6f 72 20 79 6f prompted for yo
1370: 75 72 20 47 50 47 20 70 61 73 73 70 68 72 61 73 ur GPG passphras
1380: 65 20 73 6f 0a 20 20 20 20 74 68 61 74 20 74 68 e so. that th
1390: 65 20 63 68 65 63 6b 2d 69 6e 20 63 61 6e 20 62 e check-in can b
13a0: 65 20 73 69 67 6e 65 64 20 77 69 74 68 20 79 6f e signed with yo
13b0: 75 72 20 47 50 47 20 73 69 67 6e 61 74 75 72 65 ur GPG signature
13c0: 2e 20 20 41 66 74 65 72 0a 20 20 20 20 74 68 69 . After. thi
13d0: 73 20 79 6f 75 72 20 63 68 61 6e 67 65 73 20 77 s your changes w
13e0: 69 6c 6c 20 62 65 20 63 68 65 63 6b 65 64 20 69 ill be checked i
13f0: 6e 2e 3c 2f 70 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 n.</p>..</blockq
1400: 75 6f 74 65 3e 3c 68 32 3e 53 68 61 72 69 6e 67 uote><h2>Sharing
1410: 20 43 68 61 6e 67 65 73 3c 2f 68 32 3e 3c 62 6c Changes</h2><bl
1420: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
1430: 70 3e 54 68 65 20 63 68 61 6e 67 65 73 20 79 6f p>The changes yo
1440: 75 20 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 u <b>commit</b>
1450: 61 72 65 20 6f 6e 6c 79 20 6f 6e 20 79 6f 75 72 are only on your
1460: 20 6c 6f 63 61 6c 20 72 65 70 6f 73 69 74 6f 72 local repositor
1470: 79 2e 0a 20 20 20 20 54 6f 20 73 68 61 72 65 20 y.. To share
1480: 74 68 6f 73 65 20 63 68 61 6e 67 65 73 20 77 69 those changes wi
1490: 74 68 20 6f 74 68 65 72 20 72 65 70 6f 73 69 74 th other reposit
14a0: 6f 72 69 65 73 2c 20 64 6f 3a 3c 2f 70 3e 0a 0a ories, do:</p>..
14b0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
14c0: 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 70 . <b>fossil p
14d0: 75 73 68 3c 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f ush</b> <i>URL</
14e0: 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 i>. </blockqu
14f0: 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 68 65 ote>.. <p>Whe
1500: 72 65 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 69 73 re <i>URL</i> is
1510: 20 74 68 65 20 68 74 74 70 3a 20 55 52 4c 20 6f the http: URL o
1520: 66 20 74 68 65 20 73 65 72 76 65 72 20 72 65 70 f the server rep
1530: 6f 73 69 74 6f 72 79 20 79 6f 75 0a 20 20 20 20 ository you.
1540: 77 61 6e 74 20 74 6f 20 73 68 61 72 65 20 79 6f want to share yo
1550: 75 72 20 63 68 61 6e 67 65 73 20 77 69 74 68 2e ur changes with.
1560: 20 20 49 66 20 79 6f 75 20 6f 6d 69 74 20 74 68 If you omit th
1570: 65 20 3c 69 3e 55 52 4c 3c 2f 69 3e 20 61 72 67 e <i>URL</i> arg
1580: 75 6d 65 6e 74 2c 0a 20 20 20 20 66 6f 73 73 69 ument,. fossi
1590: 6c 20 77 69 6c 6c 20 75 73 65 20 77 68 61 74 65 l will use whate
15a0: 76 65 72 20 73 65 72 76 65 72 20 79 6f 75 20 6d ver server you m
15b0: 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 73 79 6e ost recently syn
15c0: 63 65 64 20 77 69 74 68 2e 3c 2f 70 3e 0a 0a 20 ced with.</p>..
15d0: 20 20 20 3c 70 3e 54 68 65 20 3c 62 3e 70 75 73 <p>The <b>pus
15e0: 68 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 6f 6e h</b> command on
15f0: 6c 79 20 73 65 6e 64 73 20 79 6f 75 72 20 63 68 ly sends your ch
1600: 61 6e 67 65 73 20 74 6f 20 6f 74 68 65 72 73 2e anges to others.
1610: 20 20 54 6f 0a 20 20 20 20 52 65 63 65 69 76 65 To. Receive
1620: 20 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 changes from ot
1630: 68 65 72 73 2c 20 75 73 65 20 3c 62 3e 70 75 6c hers, use <b>pul
1640: 6c 3c 2f 62 3e 2e 20 20 4f 72 20 67 6f 20 62 6f l</b>. Or go bo
1650: 74 68 20 77 61 79 73 20 61 74 0a 20 20 20 20 6f th ways at. o
1660: 6e 63 65 20 75 73 69 6e 67 20 3c 62 3e 73 79 6e nce using <b>syn
1670: 63 3c 2f 62 3e 3a 3c 2f 70 3e 0a 0a 20 20 20 20 c</b>:</p>..
1680: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 <blockquote>.
1690: 20 3c 62 3e 66 6f 73 73 69 6c 20 70 75 6c 6c 3c <b>fossil pull<
16a0: 2f 62 3e 20 3c 69 3e 55 52 4c 3c 2f 69 3e 3c 62 /b> <i>URL</i><b
16b0: 72 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c r>. <b>fossil
16c0: 20 73 79 6e 63 3c 2f 62 3e 20 3c 69 3e 55 52 4c sync</b> <i>URL
16d0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block
16e0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 57 quote>.. <p>W
16f0: 68 65 6e 20 79 6f 75 20 70 75 6c 6c 20 69 6e 20 hen you pull in
1700: 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 6f 74 68 changes from oth
1710: 65 72 73 2c 20 74 68 65 79 20 67 6f 20 69 6e 74 ers, they go int
1720: 6f 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 o your repositor
1730: 79 2c 0a 20 20 20 20 6e 6f 74 20 69 6e 74 6f 20 y,. not into
1740: 79 6f 75 72 20 63 68 65 63 6b 65 64 2d 6f 75 74 your checked-out
1750: 20 6c 6f 63 61 6c 20 74 72 65 65 2e 20 20 54 6f local tree. To
1760: 20 67 65 74 20 74 68 65 20 63 68 61 6e 67 65 73 get the changes
1770: 20 69 6e 74 6f 20 79 6f 75 72 0a 20 20 20 20 6c into your. l
1780: 6f 63 61 6c 20 74 72 65 65 2c 20 75 73 65 20 3c ocal tree, use <
1790: 62 3e 75 70 64 61 74 65 3c 2f 62 3e 3a 3c 2f 70 b>update</b>:</p
17a0: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
17b0: 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 te>. <b>fossi
17c0: 6c 20 75 70 64 61 74 65 3c 2f 62 3e 20 3c 69 3e l update</b> <i>
17d0: 41 49 44 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c AID</i>. </bl
17e0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
17f0: 70 3e 54 68 65 20 3c 69 3e 41 49 44 3c 2f 69 3e p>The <i>AID</i>
1800: 20 69 73 20 73 6f 6d 65 20 75 6e 69 71 75 65 20 is some unique
1810: 61 62 62 72 65 76 69 61 74 69 6f 6e 20 74 6f 20 abbreviation to
1820: 74 68 65 20 34 30 2d 63 68 61 72 61 63 74 65 72 the 40-character
1830: 0a 20 20 20 20 61 72 74 69 66 61 63 74 20 69 64 . artifact id
1840: 65 6e 74 69 66 69 65 72 20 28 41 49 44 29 20 66 entifier (AID) f
1850: 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 or a particular
1860: 63 68 65 63 6b 2d 69 6e 2e 20 20 49 66 20 79 6f check-in. If yo
1870: 75 20 6f 6d 69 74 0a 20 20 20 20 74 68 65 20 3c u omit. the <
1880: 69 3e 41 49 44 3c 2f 69 3e 20 66 6f 73 73 69 6c i>AID</i> fossil
1890: 20 6d 6f 76 65 73 20 79 6f 75 20 74 6f 20 74 68 moves you to th
18a0: 65 0a 20 20 20 20 6c 65 61 66 20 76 65 72 73 69 e. leaf versi
18b0: 6f 6e 20 6f 66 20 74 68 65 20 62 72 61 6e 63 68 on of the branch
18c0: 20 79 6f 75 72 20 61 72 65 20 63 75 72 72 65 6e your are curren
18d0: 74 6c 79 20 6f 6e 2e 20 20 49 66 20 79 6f 75 72 tly on. If your
18e0: 20 62 72 61 6e 63 68 0a 20 20 20 20 68 61 73 20 branch. has
18f0: 6d 75 6c 74 69 70 6c 65 20 6c 65 61 76 65 73 2c multiple leaves,
1900: 20 79 6f 75 20 67 65 74 20 61 6e 20 65 72 72 6f you get an erro
1910: 72 20 2d 20 79 6f 75 27 6c 6c 20 68 61 76 65 20 r - you'll have
1920: 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 0a 20 to specify the.
1930: 20 20 20 6c 65 61 66 20 79 6f 75 20 77 61 6e 74 leaf you want
1940: 20 75 73 69 6e 67 20 61 20 3c 69 3e 41 49 44 3c using a <i>AID<
1950: 2f 69 3e 20 61 72 67 75 6d 65 6e 74 2e 3c 2f 70 /i> argument.</p
1960: 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e >..</blockquote>
1970: 3c 68 32 3e 42 72 61 6e 63 68 69 6e 67 20 41 6e <h2>Branching An
1980: 64 20 4d 65 72 67 69 6e 67 3c 2f 68 32 3e 3c 62 d Merging</h2><b
1990: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
19a0: 3c 70 3e 59 6f 75 20 63 61 6e 20 63 72 65 61 74 <p>You can creat
19b0: 65 20 62 72 61 6e 63 68 65 73 20 62 79 20 64 6f e branches by do
19c0: 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 63 6f 6d ing multiple com
19d0: 6d 69 74 73 20 6f 66 66 20 6f 66 20 74 68 65 0a mits off of the.
19e0: 20 20 20 20 73 61 6d 65 20 62 61 73 65 20 76 65 same base ve
19f0: 72 73 69 6f 6e 2e 20 20 54 6f 20 6d 65 72 67 65 rsion. To merge
1a00: 20 74 6f 20 62 72 61 6e 63 68 65 73 20 62 61 63 to branches bac
1a10: 6b 20 74 6f 67 65 74 68 65 72 2c 20 66 69 72 73 k together, firs
1a20: 74 0a 20 20 20 20 3c 62 3e 75 70 64 61 74 65 3c t. <b>update<
1a30: 2f 62 3e 20 74 6f 20 74 68 65 20 6c 65 61 66 20 /b> to the leaf
1a40: 6f 66 20 6f 6e 65 20 62 72 61 6e 63 68 2e 20 20 of one branch.
1a50: 54 68 65 6e 20 64 6f 20 61 20 3c 62 3e 6d 65 72 Then do a <b>mer
1a60: 67 65 3c 2f 62 3e 0a 20 20 20 20 6f 66 20 74 68 ge</b>. of th
1a70: 65 20 6c 65 61 66 20 6f 66 20 74 68 65 20 6f 74 e leaf of the ot
1a80: 68 65 72 20 62 72 61 6e 63 68 3a 3c 2f 70 3e 0a her branch:</p>.
1a90: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
1aa0: 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 >. <b>fossil
1ab0: 6d 65 72 67 65 3c 2f 62 3e 20 3c 69 3e 41 49 44 merge</b> <i>AID
1ac0: 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b </i>. </block
1ad0: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 quote>.. <p>T
1ae0: 65 73 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 est to make sure
1af0: 20 79 6f 75 72 20 6d 65 72 67 65 20 64 69 64 6e your merge didn
1b00: 27 74 20 6d 65 73 73 20 75 70 20 74 68 65 20 63 't mess up the c
1b10: 6f 64 65 2c 20 74 68 65 6e 0a 20 20 20 20 3c 62 ode, then. <b
1b20: 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 20 61 6e 64 20 >commit</b> and
1b30: 70 6f 73 73 69 62 6c 79 20 61 6c 73 6f 20 3c 62 possibly also <b
1b40: 3e 70 75 73 68 3c 2f 62 3e 20 79 6f 75 72 20 63 >push</b> your c
1b50: 68 61 6e 67 65 73 2e 20 20 20 52 65 6d 65 6d 62 hanges. Rememb
1b60: 65 72 0a 20 20 20 20 74 68 61 74 20 6e 6f 62 6f er. that nobo
1b70: 64 79 20 65 6c 73 65 20 63 61 6e 20 73 65 65 20 dy else can see
1b80: 79 6f 75 72 20 63 68 61 6e 67 65 73 20 75 6e 74 your changes unt
1b90: 69 6c 20 79 6f 75 20 3c 62 3e 63 6f 6d 6d 69 74 il you <b>commit
1ba0: 3c 2f 62 3e 20 61 6e 64 0a 20 20 20 20 69 66 20 </b> and. if
1bb0: 6f 74 68 65 72 20 61 72 65 20 75 73 69 6e 67 20 other are using
1bc0: 61 20 64 69 66 66 65 72 65 6e 74 20 72 65 70 6f a different repo
1bd0: 73 69 74 6f 72 79 20 79 6f 75 20 77 69 6c 6c 20 sitory you will
1be0: 61 6c 73 6f 20 6e 65 65 64 20 74 6f 0a 20 20 20 also need to.
1bf0: 20 3c 62 3e 70 75 73 68 3c 2f 62 3e 2e 3c 2f 70 <b>push</b>.</p
1c00: 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22 73 65 72 76 >..<a name="serv
1c10: 65 72 73 65 74 75 70 22 3e 3c 2f 61 3e 0a 3c 2f ersetup"></a>.</
1c20: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 68 32 3e 53 blockquote><h2>S
1c30: 65 74 74 69 6e 67 20 55 70 20 41 20 53 65 72 76 etting Up A Serv
1c40: 65 72 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f er</h2><blockquo
1c50: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 te>.. <p>The
1c60: 65 61 73 69 65 73 74 20 77 61 79 20 74 6f 20 73 easiest way to s
1c70: 65 74 20 75 70 20 61 20 73 65 72 76 65 72 20 69 et up a server i
1c80: 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f s:</p>.. <blo
1c90: 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e ckquote>. <b>
1ca0: 66 6f 73 73 69 6c 20 73 65 72 76 65 72 3c 2f 62 fossil server</b
1cb0: 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f 72 79 2d > <i>repository-
1cc0: 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a 20 20 20 filename</i>.
1cd0: 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a </blockquote>..
1ce0: 20 20 20 20 3c 70 3e 4f 72 3c 2f 62 3e 0a 0a 20 <p>Or</b>..
1cf0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
1d00: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 75 69 <b>fossil ui
1d10: 3c 2f 62 3e 20 3c 69 3e 72 65 70 6f 73 69 74 6f </b> <i>reposito
1d20: 72 79 2d 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 0a ry-filename</i>.
1d30: 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 </blockquote
1d40: 3e 0a 0a 20 20 20 20 3c 70 3e 54 68 65 20 64 69 >.. <p>The di
1d50: 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e fference between
1d60: 20 74 68 65 73 65 20 74 77 6f 20 63 6f 6d 6d 61 these two comma
1d70: 6e 64 20 69 73 20 74 68 61 74 20 3c 62 3e 75 69 nd is that <b>ui
1d80: 3c 2f 62 3e 0a 20 20 20 20 61 74 74 65 6d 70 74 </b>. attempt
1d90: 73 20 74 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c s to automatical
1da0: 6c 79 20 73 74 61 72 74 20 79 6f 75 72 20 77 65 ly start your we
1db0: 62 20 62 72 6f 77 73 65 72 20 70 6f 69 6e 74 69 b browser pointi
1dc0: 6e 67 20 61 74 20 74 68 65 0a 20 20 20 20 73 65 ng at the. se
1dd0: 72 76 65 72 20 77 68 65 72 65 61 73 20 3c 62 3e rver whereas <b>
1de0: 73 65 72 76 65 72 3c 2f 62 3e 20 64 6f 65 73 20 server</b> does
1df0: 6e 6f 74 2e 0a 20 20 20 20 59 6f 75 20 63 61 6e not.. You can
1e00: 20 6f 6d 69 74 20 74 68 65 20 3c 69 3e 72 65 70 omit the <i>rep
1e10: 6f 73 69 74 6f 72 79 2d 66 69 6c 65 6e 61 6d 65 ository-filename
1e20: 3c 2f 69 3e 20 69 66 20 79 6f 75 20 61 72 65 20 </i> if you are
1e30: 77 69 74 68 69 6e 0a 20 20 20 20 61 20 63 68 65 within. a che
1e40: 63 6b 65 64 2d 6f 75 74 20 6c 6f 63 61 6c 20 74 cked-out local t
1e50: 72 65 65 2e 20 20 54 68 69 73 20 73 65 72 76 65 ree. This serve
1e60: 72 20 75 73 65 73 20 70 6f 72 74 20 38 30 38 30 r uses port 8080
1e70: 20 62 79 20 64 65 66 61 75 6c 74 0a 20 20 20 20 by default.
1e80: 62 75 74 20 79 6f 75 20 63 61 6e 20 73 70 65 63 but you can spec
1e90: 69 66 79 20 61 20 64 69 66 66 65 72 65 6e 74 20 ify a different
1ea0: 70 6f 72 74 20 75 73 69 6e 67 20 74 68 65 20 3c port using the <
1eb0: 62 3e 2d 70 6f 72 74 3c 2f 62 3e 20 63 6f 6d 6d b>-port</b> comm
1ec0: 61 6e 64 2e 3c 2f 70 3e 0a 0a 20 20 20 20 3c 70 and.</p>.. <p
1ed0: 3e 43 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 73 65 >Command-line se
1ee0: 72 76 65 72 73 20 6c 69 6b 65 20 74 68 69 73 20 rvers like this
1ef0: 61 72 65 20 75 73 65 66 75 6c 20 77 68 65 6e 20 are useful when
1f00: 74 77 6f 20 70 65 6f 70 6c 65 20 77 61 6e 74 0a two people want.
1f10: 20 20 20 20 74 6f 20 73 68 61 72 65 20 61 20 72 to share a r
1f20: 65 70 6f 73 69 74 6f 72 79 20 6f 6e 20 74 65 6d epository on tem
1f30: 70 6f 72 61 72 79 20 6f 72 20 61 64 2d 68 6f 63 porary or ad-hoc
1f40: 20 62 61 73 69 73 2e 20 20 46 6f 72 20 61 20 6d basis. For a m
1f50: 6f 72 65 0a 20 20 20 20 70 65 72 6d 61 6e 65 6e ore. permanen
1f60: 74 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 t installation,
1f70: 79 6f 75 20 73 68 6f 75 6c 64 20 75 73 65 20 65 you should use e
1f80: 69 74 68 65 72 20 74 68 65 20 43 47 49 20 73 65 ither the CGI se
1f90: 72 76 65 72 20 6f 72 20 74 68 65 0a 20 20 20 20 rver or the.
1fa0: 69 6e 65 74 64 20 73 65 72 76 65 72 2e 0a 20 20 inetd server..
1fb0: 20 20 3c 61 20 6e 61 6d 65 3d 22 63 67 69 73 65 <a name="cgise
1fc0: 72 76 65 72 22 3e 3c 2f 61 3e 0a 20 20 20 20 54 rver"></a>. T
1fd0: 6f 20 75 73 65 20 74 68 65 20 43 47 49 20 73 65 o use the CGI se
1fe0: 72 76 65 72 2c 20 63 72 65 61 74 65 20 61 20 43 rver, create a C
1ff0: 47 49 20 73 63 72 69 70 74 20 74 68 61 74 0a 20 GI script that.
2000: 20 20 20 6c 6f 6f 6b 73 20 73 6f 6d 65 74 68 69 looks somethi
2010: 6e 67 20 6c 69 6b 65 20 74 68 69 73 3a 3c 2f 70 ng like this:</p
2020: 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f >.. <blockquo
2030: 74 65 3e 3c 62 3e 0a 20 20 20 20 23 21 2f 75 73 te><b>. #!/us
2040: 72 2f 6c 6f 63 61 6c 2f 62 69 6e 2f 66 6f 73 73 r/local/bin/foss
2050: 69 6c 3c 62 72 3e 0a 20 20 20 20 72 65 70 6f 73 il<br>. repos
2060: 69 74 6f 72 79 3a 20 2f 68 6f 6d 65 2f 70 72 6f itory: /home/pro
2070: 6a 31 2f 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c j1/repos1.fossil
2080: 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b . </b></block
2090: 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 quote>.. <p>A
20a0: 64 6a 75 73 74 20 74 68 65 20 70 61 74 68 73 20 djust the paths
20b0: 69 6e 20 74 68 69 73 20 43 47 49 20 73 63 72 69 in this CGI scri
20c0: 70 74 20 74 6f 20 6d 61 74 63 68 20 79 6f 75 72 pt to match your
20d0: 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 installation.
20e0: 20 20 61 6e 64 20 6d 61 6b 65 20 73 75 72 65 20 and make sure
20f0: 74 68 61 74 20 72 65 70 6f 73 69 74 6f 72 79 20 that repository
2100: 66 69 6c 65 20 61 74 20 74 68 65 20 64 69 72 65 file at the dire
2110: 63 74 6f 72 79 20 74 68 61 74 20 63 6f 6e 74 61 ctory that conta
2120: 69 6e 73 20 69 74 0a 20 20 20 20 61 72 65 20 62 ins it. are b
2130: 6f 74 68 20 72 65 61 64 61 62 6c 65 20 61 6e 64 oth readable and
2140: 20 77 72 69 74 61 62 6c 65 20 62 79 20 74 68 65 writable by the
2150: 20 75 73 65 72 20 74 68 61 74 20 43 47 49 20 73 user that CGI s
2160: 63 72 69 70 74 73 20 72 75 6e 20 61 73 2e 0a 20 cripts run as..
2170: 20 20 20 54 68 65 6e 20 70 6f 69 6e 74 20 63 6c Then point cl
2180: 69 65 6e 74 73 20 61 74 20 74 68 65 20 43 47 49 ients at the CGI
2190: 20 73 63 72 69 70 74 2e 20 20 54 68 61 74 27 73 script. That's
21a0: 20 61 6c 6c 20 74 68 65 72 65 20 69 73 20 74 6f all there is to
21b0: 20 69 74 21 3c 2f 70 3e 0a 0a 20 20 20 20 3c 61 it!</p>.. <a
21c0: 20 6e 61 6d 65 3d 22 69 6e 65 74 64 73 65 72 76 name="inetdserv
21d0: 65 72 22 3e 3c 2f 61 3e 0a 20 20 20 20 3c 70 3e er"></a>. <p>
21e0: 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 72 75 6e You can also run
21f0: 20 66 6f 73 73 69 6c 20 6f 66 66 20 6f 66 20 69 fossil off of i
2200: 6e 65 74 64 20 6f 72 20 78 69 6e 65 74 64 2e 20 netd or xinetd.
2210: 20 46 6f 72 20 61 6e 20 69 6e 65 74 64 0a 20 20 For an inetd.
2220: 20 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2c 20 installation,
2230: 6d 61 6b 65 20 61 6e 20 65 6e 74 72 79 20 69 6e make an entry in
2240: 20 2f 65 74 63 2f 69 6e 65 74 64 2e 63 6f 6e 66 /etc/inetd.conf
2250: 20 74 68 61 74 20 6c 6f 6f 6b 73 20 73 6f 6d 65 that looks some
2260: 74 68 69 6e 67 0a 20 20 20 20 6c 69 6b 65 20 74 thing. like t
2270: 68 69 73 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 his:</p>.. <b
2280: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e 0a 20 20 lockquote><b>.
2290: 20 20 38 30 20 73 74 72 65 61 6d 20 74 63 70 20 80 stream tcp
22a0: 6e 6f 77 61 69 74 2e 31 30 30 30 20 72 6f 6f 74 nowait.1000 root
22b0: 20 2f 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c /usr/bin/fossil
22c0: 20 5c 3c 62 72 3e 0a 20 20 20 20 20 20 20 20 2f \<br>. /
22d0: 75 73 72 2f 62 69 6e 2f 66 6f 73 73 69 6c 20 68 usr/bin/fossil h
22e0: 74 74 70 20 2f 68 6f 6d 65 2f 70 72 6f 6a 31 2f ttp /home/proj1/
22f0: 72 65 70 6f 73 31 2e 66 6f 73 73 69 6c 0a 20 20 repos1.fossil.
2300: 20 20 3c 2f 62 3e 3c 2f 62 6c 6f 63 6b 71 75 6f </b></blockquo
2310: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 41 64 6a 75 te>.. <p>Adju
2320: 73 74 20 74 68 65 20 70 61 74 68 73 20 74 6f 20 st the paths to
2330: 73 75 69 74 20 79 6f 75 72 20 69 6e 73 74 61 6c suit your instal
2340: 6c 61 74 69 6f 6e 2c 20 6f 66 20 63 6f 75 72 73 lation, of cours
2350: 65 2e 20 20 4e 6f 74 69 63 65 20 74 68 61 74 0a e. Notice that.
2360: 20 20 20 20 66 6f 73 73 69 6c 20 72 75 6e 73 20 fossil runs
2370: 61 73 20 72 6f 6f 74 2e 20 20 54 68 69 73 20 69 as root. This i
2380: 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 20 2d s not required -
2390: 20 79 6f 75 20 63 61 6e 20 72 75 6e 20 69 74 20 you can run it
23a0: 61 73 20 61 6e 0a 20 20 20 20 75 6e 70 72 69 76 as an. unpriv
23b0: 69 6c 65 67 65 64 20 75 73 65 72 2e 20 20 42 75 ileged user. Bu
23c0: 74 20 69 74 20 69 73 20 6d 6f 72 65 20 73 65 63 t it is more sec
23d0: 75 72 65 20 74 6f 20 72 75 6e 20 66 6f 73 73 69 ure to run fossi
23e0: 6c 20 61 73 20 72 6f 6f 74 2e 0a 20 20 20 20 57 l as root.. W
23f0: 68 65 6e 20 79 6f 75 20 64 6f 20 72 75 6e 20 66 hen you do run f
2400: 6f 73 73 69 6c 20 61 73 20 72 6f 6f 74 2c 20 69 ossil as root, i
2410: 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 t automatically
2420: 70 75 74 73 20 69 74 73 65 6c 66 20 69 6e 20 61 puts itself in a
2430: 0a 20 20 20 20 63 68 72 6f 6f 74 20 6a 61 69 6c . chroot jail
2440: 20 69 6e 20 74 68 65 20 73 61 6d 65 20 64 69 72 in the same dir
2450: 65 63 74 6f 72 79 20 61 73 20 74 68 65 20 72 65 ectory as the re
2460: 70 6f 73 69 74 6f 72 79 2c 20 74 68 65 6e 20 64 pository, then d
2470: 72 6f 70 73 0a 20 20 20 20 72 6f 6f 74 20 70 72 rops. root pr
2480: 69 76 69 6c 65 67 65 73 20 70 72 69 6f 72 20 74 ivileges prior t
2490: 6f 20 72 65 61 64 69 6e 67 20 61 6e 79 20 69 6e o reading any in
24a0: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 formation from t
24b0: 68 65 20 72 65 71 75 65 73 74 2e 3c 2f 70 3e 0a he request.</p>.
24c0: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 61 .</blockquote><a
24d0: 20 6e 61 6d 65 3d 22 70 72 6f 78 79 22 3e 3c 2f name="proxy"></
24e0: 61 3e 3c 68 32 3e 48 54 54 50 20 50 72 6f 78 69 a><h2>HTTP Proxi
24f0: 65 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f es</h2><blockquo
2500: 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 66 20 79 te>.. <p>If y
2510: 6f 75 20 61 72 65 20 62 65 68 69 6e 64 20 61 20 ou are behind a
2520: 72 65 73 74 72 69 63 74 69 76 65 20 66 69 72 65 restrictive fire
2530: 77 61 6c 6c 20 74 68 61 74 20 72 65 71 75 69 72 wall that requir
2540: 65 73 20 79 6f 75 20 74 6f 20 75 73 65 0a 20 20 es you to use.
2550: 20 20 61 6e 20 48 54 54 50 20 70 72 6f 78 79 20 an HTTP proxy
2560: 74 6f 20 72 65 61 63 68 20 74 68 65 20 69 6e 74 to reach the int
2570: 65 72 6e 65 74 2c 20 74 68 65 6e 20 79 6f 75 20 ernet, then you
2580: 63 61 6e 20 63 6f 6e 66 69 67 75 72 65 20 74 68 can configure th
2590: 65 20 70 72 6f 78 79 0a 20 20 20 20 69 6e 20 74 e proxy. in t
25a0: 68 72 65 65 20 64 69 66 66 65 72 65 6e 74 20 77 hree different w
25b0: 61 79 73 2e 20 20 59 6f 75 20 63 61 6e 20 74 65 ays. You can te
25c0: 6c 6c 20 66 6f 73 73 69 6c 20 61 62 6f 75 74 20 ll fossil about
25d0: 79 6f 75 72 20 70 72 6f 78 79 20 75 73 69 6e 67 your proxy using
25e0: 0a 20 20 20 20 61 20 63 6f 6d 6d 61 6e 64 2d 6c . a command-l
25f0: 69 6e 65 20 6f 70 74 69 6f 6e 20 6f 6e 20 63 6f ine option on co
2600: 6d 6d 61 6e 64 73 20 74 68 61 74 20 75 73 65 20 mmands that use
2610: 74 68 65 20 6e 65 74 77 6f 72 6b 2c 0a 20 20 20 the network,.
2620: 20 3c 62 3e 73 79 6e 63 3c 2f 62 3e 2c 20 3c 62 <b>sync</b>, <b
2630: 3e 63 6c 6f 6e 65 3c 2f 62 3e 2c 20 3c 62 3e 70 >clone</b>, <b>p
2640: 75 73 68 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 3e ush</b>, and <b>
2650: 70 75 6c 6c 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 20 pull</b>.</p>..
2660: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a <blockquote>.
2670: 20 20 20 20 3c 62 3e 66 6f 73 73 69 6c 20 63 6c <b>fossil cl
2680: 6f 6e 65 20 3c 2f 62 3e 3c 69 3e 55 52 4c 3c 2f one </b><i>URL</
2690: 69 3e 20 20 3c 62 3e 2d 2d 70 72 6f 78 79 3c 2f i> <b>--proxy</
26a0: 62 3e 20 3c 69 3e 50 72 6f 78 79 2d 55 52 4c 3c b> <i>Proxy-URL<
26b0: 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 /i>. </blockq
26c0: 75 6f 74 65 3e 0a 0a 20 20 20 20 3c 70 3e 49 74 uote>.. <p>It
26d0: 20 69 73 20 61 6e 6e 6f 79 69 6e 67 20 74 6f 20 is annoying to
26e0: 68 61 76 65 20 74 6f 20 74 79 70 65 20 69 6e 20 have to type in
26f0: 74 68 65 20 70 72 6f 78 79 20 55 52 4c 20 65 76 the proxy URL ev
2700: 65 72 79 20 74 69 6d 65 20 79 6f 75 0a 20 20 20 ery time you.
2710: 20 73 79 6e 63 20 79 6f 75 72 20 70 72 6f 6a 65 sync your proje
2720: 63 74 2c 20 74 68 6f 75 67 68 2c 20 73 6f 20 79 ct, though, so y
2730: 6f 75 20 63 61 6e 20 6d 61 6b 65 20 74 68 65 20 ou can make the
2740: 70 72 6f 78 79 20 63 6f 6e 66 69 67 75 72 61 74 proxy configurat
2750: 69 6f 6e 0a 20 20 20 20 70 65 72 73 69 73 74 65 ion. persiste
2760: 6e 74 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e nt using the <b>
2770: 73 65 74 74 69 6e 67 3c 2f 62 3e 20 63 6f 6d 6d setting</b> comm
2780: 61 6e 64 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 and:</p>.. <b
2790: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
27a0: 62 3e 66 6f 73 73 69 6c 20 73 65 74 74 69 6e 67 b>fossil setting
27b0: 20 70 72 6f 78 79 20 3c 2f 62 3e 3c 69 3e 50 72 proxy </b><i>Pr
27c0: 6f 78 79 2d 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 oxy-URL</i>.
27d0: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 </blockquote>..
27e0: 20 20 20 3c 70 3e 4f 72 2c 20 79 6f 75 20 63 61 <p>Or, you ca
27f0: 6e 20 73 65 74 20 74 68 65 20 22 3c 62 3e 68 74 n set the "<b>ht
2800: 74 70 5f 70 72 6f 78 79 3c 2f 62 3e 22 20 65 6e tp_proxy</b>" en
2810: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
2820: 6c 65 3a 3c 2f 70 3e 0a 0a 20 20 20 20 3c 62 6c le:</p>.. <bl
2830: 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 62 ockquote>. <b
2840: 3e 65 78 70 6f 72 74 20 68 74 74 70 5f 70 72 6f >export http_pro
2850: 78 79 3d 3c 2f 62 3e 3c 69 3e 50 72 6f 78 79 2d xy=</b><i>Proxy-
2860: 55 52 4c 3c 2f 69 3e 0a 20 20 20 20 3c 2f 62 6c URL</i>. </bl
2870: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 3c ockquote>.. <
2880: 70 3e 54 6f 20 73 74 6f 70 20 75 73 69 6e 67 20 p>To stop using
2890: 74 68 65 20 70 72 6f 78 79 2c 20 64 6f 3a 3c 2f the proxy, do:</
28a0: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu
28b0: 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 73 ote>. <b>foss
28c0: 69 6c 20 73 65 74 74 69 6e 67 20 70 72 6f 78 79 il setting proxy
28d0: 20 6f 66 66 3c 2f 62 3e 0a 20 20 20 20 3c 2f 62 off</b>. </b
28e0: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
28f0: 3c 70 3e 4f 72 20 75 6e 73 65 74 20 74 68 65 20 <p>Or unset the
2900: 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 environment vari
2910: 61 62 6c 65 2e 20 20 54 68 65 20 66 6f 73 73 69 able. The fossi
2920: 6c 20 73 65 74 74 69 6e 67 20 66 6f 72 20 74 68 l setting for th
2930: 65 0a 20 20 20 20 48 54 54 50 20 70 72 6f 78 79 e. HTTP proxy
2940: 20 74 61 6b 65 73 20 70 72 65 63 65 64 65 6e 63 takes precedenc
2950: 65 20 6f 76 65 72 20 74 68 65 20 65 6e 76 69 72 e over the envir
2960: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 20 onment variable
2970: 61 6e 64 20 74 68 65 0a 20 20 20 20 63 6f 6d 6d and the. comm
2980: 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 and-line option
2990: 6f 76 65 72 72 69 64 65 73 20 62 6f 74 68 2e 20 overrides both.
29a0: 20 49 66 20 79 6f 75 20 68 61 76 65 20 61 6e 20 If you have an
29b0: 70 65 72 73 69 73 74 65 6e 74 0a 20 20 20 20 70 persistent. p
29c0: 72 6f 78 79 20 73 65 74 74 69 6e 67 20 74 68 61 roxy setting tha
29d0: 74 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 6f 76 t you want to ov
29e0: 65 72 72 69 64 65 20 66 6f 72 20 61 20 6f 6e 65 erride for a one
29f0: 2d 74 69 6d 65 20 73 79 6e 63 2c 20 74 68 61 74 -time sync, that
2a00: 0a 20 20 20 20 69 73 20 65 61 73 69 6c 79 20 64 . is easily d
2a10: 6f 6e 65 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 one on the comma
2a20: 6e 64 2d 6c 69 6e 65 2e 20 20 46 6f 72 20 65 78 nd-line. For ex
2a30: 61 6d 70 6c 65 2c 20 74 6f 20 73 79 6e 63 20 77 ample, to sync w
2a40: 69 74 68 0a 20 20 20 20 61 20 63 6f 2d 77 6f 72 ith. a co-wor
2a50: 6b 65 72 73 20 72 65 70 6f 73 69 74 6f 72 79 20 kers repository
2a60: 6f 6e 20 79 6f 75 72 20 4c 41 4e 2c 20 79 6f 75 on your LAN, you
2a70: 20 6d 69 67 68 74 20 74 79 70 65 3a 3c 2f 70 3e might type:</p>
2a80: 20 20 20 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 .. <blockq
2a90: 75 6f 74 65 3e 0a 20 20 20 20 3c 62 3e 66 6f 73 uote>. <b>fos
2aa0: 73 69 6c 20 73 79 6e 63 20 68 74 74 70 3a 2f 2f sil sync http://
2ab0: 31 39 32 2e 31 36 38 2e 31 2e 33 36 3a 38 30 38 192.168.1.36:808
2ac0: 30 2f 20 2d 2d 70 72 6f 78 79 20 6f 66 66 3c 2f 0/ --proxy off</
2ad0: 62 3e 0a 20 20 20 20 3c 2f 62 6c 6f 63 6b 71 75 b>. </blockqu
2ae0: 6f 74 65 3e 0a 0a 3c 2f 62 6c 6f 63 6b 71 75 6f ote>..</blockquo
2af0: 74 65 3e 3c 68 32 3e 4d 6f 72 65 20 48 69 6e 74 te><h2>More Hint
2b00: 73 3c 2f 68 32 3e 3c 62 6c 6f 63 6b 71 75 6f 74 s</h2><blockquot
2b10: 65 3e 0a 0a 20 20 20 20 3c 70 3e 54 72 79 20 74 e>.. <p>Try t
2b20: 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 3a 3c 2f hese commands:</
2b30: 70 3e 0a 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 p>.. <blockqu
2b40: 6f 74 65 3e 3c 62 3e 0a 20 20 20 20 66 6f 73 73 ote><b>. foss
2b50: 69 6c 20 68 65 6c 70 3c 62 72 3e 0a 20 20 20 20 il help<br>.
2b60: 66 6f 73 73 69 6c 20 74 65 73 74 2d 63 6f 6d 6d fossil test-comm
2b70: 61 6e 64 73 0a 20 20 20 20 3c 2f 62 3e 3c 2f 62 ands. </b></b
2b80: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
2b90: 3c 70 3e 45 78 70 6c 6f 72 65 20 61 6e 64 20 68 <p>Explore and h
2ba0: 61 76 65 20 66 75 6e 21 3c 2f 70 3e 0a 0a 0a 3c ave fun!</p>...<
2bb0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 6e /blockquote>.</n
2bc0: 6f 77 69 6b 69 3e 0a owiki>.