Differences From:

File www/quickstart.html part of check-in [c7438f6dc9] - Fix the fossil repository URL in the quickstart.html document. by drh on 2008-05-05 18:39:36. [view]

To:

File www/quickstart.html part of check-in [c507cfa76b] - Updates to quickstart document to talk about setting up a proxy. by drh on 2008-05-05 19:33:48. [view]

@@ -34,8 +34,11 @@
     <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>
@@ -216,8 +219,33 @@
     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>