SHA1 Hash:	c507cfa76b3982a2f844219fb03fe7bb1958f304
Date:	2008-05-05 19:33:48
User:	drh
Comment:	Updates to quickstart document to talk about setting up a proxy.
Timelines:	ancestors | descendants | both | trunk
Other Links:	files | ZIP archive | manifest

• branch=trunk inherited from [a28c83647d]
• sym-trunk inherited from [a28c83647d]

Modified www/quickstart.html from [fee246136e] to [f0a6ad1585].

@@ -33,10 +33,13 @@
 
     <blockquote>
     <b>fossil clone http://www.fossil-scm.org/fossil myclone.fsl</b>
     </blockquote>
 
+    <p>Note: If you are behind a restrictive firewall, you might need
+    to <a href="#proxy">specify an HTTP proxy</a> to use.</p>
+
 </blockquote><h2>Starting A New Project</h2><blockquote>
 
     <p>To start a new project with fossil, create a new empty repository
     this way:</p>
 
@@ -215,10 +218,35 @@
     fossil runs as root.  This is not required - you can run it as an
     unprivileged user.  But it is more secure to run fossil as root.
     When you do run fossil as root, it automatically puts itself in a
     chroot jail in the same directory as the repository, then drops
     root privileges prior to reading any information from the request.</p>
+
+</blockquote><a name="proxy"></a><h2>HTTP Proxies</h2><blockquote>
+
+    <p>If you are behind a restrictive firewall that requires you to use
+    an HTTP proxy to reach the internet, then you can configure the proxy
+    in one of two ways.  You can tell fossil about your proxy like this:<p>
+
+    <blockquote>
+    <b>fossil setting proxy </b><i>Proxy-URL</i>
+    </blockquote>
+
+    <p>Or, you can set the "<b>http_proxy</b>" environment variable:</p>
+
+    <blockquote>
+    <b>export http_proxy=</b><i>Proxy-URL</i>
+    </blockquote>
+
+    <p>To stop using the proxy, do:</p>
+
+    <blockquote>
+    <b>fossil setting proxy off</b>
+    </blockquote>
+
+    <p>Or unset the environment variable.  The fossil setting for the
+    HTTP proxy takes precedence over the environment variable.</p>
 
 </blockquote><h2>More Hints</h2><blockquote>
 
     <p>Try these commands:</p>