Fossil SCM
Updates to quickstart document to talk about setting up a proxy.
Commit
c507cfa76b3982a2f844219fb03fe7bb1958f304
Parent
1dbf332352efea4…
1 file changed
+28
+28
| --- www/quickstart.html | ||
| +++ www/quickstart.html | ||
| @@ -32,10 +32,13 @@ | ||
| 32 | 32 | clone the fossil repository this way:</p> |
| 33 | 33 | |
| 34 | 34 | <blockquote> |
| 35 | 35 | <b>fossil clone http://www.fossil-scm.org/fossil myclone.fsl</b> |
| 36 | 36 | </blockquote> |
| 37 | + | |
| 38 | + <p>Note: If you are behind a restrictive firewall, you might need | |
| 39 | + to <a href="#proxy">specify an HTTP proxy</a> to use.</p> | |
| 37 | 40 | |
| 38 | 41 | </blockquote><h2>Starting A New Project</h2><blockquote> |
| 39 | 42 | |
| 40 | 43 | <p>To start a new project with fossil, create a new empty repository |
| 41 | 44 | this way:</p> |
| @@ -216,10 +219,35 @@ | ||
| 216 | 219 | unprivileged user. But it is more secure to run fossil as root. |
| 217 | 220 | When you do run fossil as root, it automatically puts itself in a |
| 218 | 221 | chroot jail in the same directory as the repository, then drops |
| 219 | 222 | root privileges prior to reading any information from the request.</p> |
| 220 | 223 | |
| 224 | +</blockquote><a name="proxy"></a><h2>HTTP Proxies</h2><blockquote> | |
| 225 | + | |
| 226 | + <p>If you are behind a restrictive firewall that requires you to use | |
| 227 | + an HTTP proxy to reach the internet, then you can configure the proxy | |
| 228 | + in one of two ways. You can tell fossil about your proxy like this:<p> | |
| 229 | + | |
| 230 | + <blockquote> | |
| 231 | + <b>fossil setting proxy </b><i>Proxy-URL</i> | |
| 232 | + </blockquote> | |
| 233 | + | |
| 234 | + <p>Or, you can set the "<b>http_proxy</b>" environment variable:</p> | |
| 235 | + | |
| 236 | + <blockquote> | |
| 237 | + <b>export http_proxy=</b><i>Proxy-URL</i> | |
| 238 | + </blockquote> | |
| 239 | + | |
| 240 | + <p>To stop using the proxy, do:</p> | |
| 241 | + | |
| 242 | + <blockquote> | |
| 243 | + <b>fossil setting proxy off</b> | |
| 244 | + </blockquote> | |
| 245 | + | |
| 246 | + <p>Or unset the environment variable. The fossil setting for the | |
| 247 | + HTTP proxy takes precedence over the environment variable.</p> | |
| 248 | + | |
| 221 | 249 | </blockquote><h2>More Hints</h2><blockquote> |
| 222 | 250 | |
| 223 | 251 | <p>Try these commands:</p> |
| 224 | 252 | |
| 225 | 253 | <blockquote><b> |
| 226 | 254 |
| --- www/quickstart.html | |
| +++ www/quickstart.html | |
| @@ -32,10 +32,13 @@ | |
| 32 | clone the fossil repository this way:</p> |
| 33 | |
| 34 | <blockquote> |
| 35 | <b>fossil clone http://www.fossil-scm.org/fossil myclone.fsl</b> |
| 36 | </blockquote> |
| 37 | |
| 38 | </blockquote><h2>Starting A New Project</h2><blockquote> |
| 39 | |
| 40 | <p>To start a new project with fossil, create a new empty repository |
| 41 | this way:</p> |
| @@ -216,10 +219,35 @@ | |
| 216 | unprivileged user. But it is more secure to run fossil as root. |
| 217 | When you do run fossil as root, it automatically puts itself in a |
| 218 | chroot jail in the same directory as the repository, then drops |
| 219 | root privileges prior to reading any information from the request.</p> |
| 220 | |
| 221 | </blockquote><h2>More Hints</h2><blockquote> |
| 222 | |
| 223 | <p>Try these commands:</p> |
| 224 | |
| 225 | <blockquote><b> |
| 226 |
| --- www/quickstart.html | |
| +++ www/quickstart.html | |
| @@ -32,10 +32,13 @@ | |
| 32 | clone the fossil repository this way:</p> |
| 33 | |
| 34 | <blockquote> |
| 35 | <b>fossil clone http://www.fossil-scm.org/fossil myclone.fsl</b> |
| 36 | </blockquote> |
| 37 | |
| 38 | <p>Note: If you are behind a restrictive firewall, you might need |
| 39 | to <a href="#proxy">specify an HTTP proxy</a> to use.</p> |
| 40 | |
| 41 | </blockquote><h2>Starting A New Project</h2><blockquote> |
| 42 | |
| 43 | <p>To start a new project with fossil, create a new empty repository |
| 44 | this way:</p> |
| @@ -216,10 +219,35 @@ | |
| 219 | unprivileged user. But it is more secure to run fossil as root. |
| 220 | When you do run fossil as root, it automatically puts itself in a |
| 221 | chroot jail in the same directory as the repository, then drops |
| 222 | root privileges prior to reading any information from the request.</p> |
| 223 | |
| 224 | </blockquote><a name="proxy"></a><h2>HTTP Proxies</h2><blockquote> |
| 225 | |
| 226 | <p>If you are behind a restrictive firewall that requires you to use |
| 227 | an HTTP proxy to reach the internet, then you can configure the proxy |
| 228 | in one of two ways. You can tell fossil about your proxy like this:<p> |
| 229 | |
| 230 | <blockquote> |
| 231 | <b>fossil setting proxy </b><i>Proxy-URL</i> |
| 232 | </blockquote> |
| 233 | |
| 234 | <p>Or, you can set the "<b>http_proxy</b>" environment variable:</p> |
| 235 | |
| 236 | <blockquote> |
| 237 | <b>export http_proxy=</b><i>Proxy-URL</i> |
| 238 | </blockquote> |
| 239 | |
| 240 | <p>To stop using the proxy, do:</p> |
| 241 | |
| 242 | <blockquote> |
| 243 | <b>fossil setting proxy off</b> |
| 244 | </blockquote> |
| 245 | |
| 246 | <p>Or unset the environment variable. The fossil setting for the |
| 247 | HTTP proxy takes precedence over the environment variable.</p> |
| 248 | |
| 249 | </blockquote><h2>More Hints</h2><blockquote> |
| 250 | |
| 251 | <p>Try these commands:</p> |
| 252 | |
| 253 | <blockquote><b> |
| 254 |