doc/webserver/faq/installation.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2 "http://www.w3.org/TR/html4/loose.dtd">
   3
   4 <html>
   5 <head>
   6   <title>Installation</title>
   7   <meta name="GENERATOR" content=
   8   "Modular DocBook HTML Stylesheet Version 1.79">
   9   <link rel="HOME" title="Privoxy Frequently Asked Questions" href=
  10   "index.html">
  11   <link rel="PREVIOUS" title="General Information" href="general.html">
  12   <link rel="NEXT" title="Configuration" href="configuration.html">
  13   <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  14   <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  15   <style type="text/css">
  16 body {
  17   background-color: #EEEEEE;
  18   color: #000000;
  19   }
  20   :link { color: #0000FF }
  21   :visited { color: #840084 }
  22   :active { color: #0000FF }
  23   span.c2 {font-style: italic}
  24   hr.c1 {text-align: left}
  25   </style>
  26 </head>
  27
  28 <body class="SECT1">
  29   <div class="NAVHEADER">
  30     <table summary="Header navigation table" width="100%" border="0"
  31     cellpadding="0" cellspacing="0">
  32       <tr>
  33         <th colspan="3" align="center">Privoxy Frequently Asked
  34         Questions</th>
  35       </tr>
  36
  37       <tr>
  38         <td width="10%" align="left" valign="bottom"><a href="general.html"
  39         accesskey="P">Prev</a></td>
  40
  41         <td width="80%" align="center" valign="bottom"></td>
  42
  43         <td width="10%" align="right" valign="bottom"><a href=
  44         "configuration.html" accesskey="N">Next</a></td>
  45       </tr>
  46     </table>
  47     <hr class="c1" width="100%">
  48   </div>
  49
  50   <div class="SECT1">
  51     <h1 class="SECT1"><a name="INSTALLATION" id="INSTALLATION">2.
  52     Installation</a></h1>
  53
  54     <div class="SECT2">
  55       <h3 class="SECT2"><a name="WHICHBROWSERS" id="WHICHBROWSERS">2.1. Which
  56       browsers are supported by Privoxy?</a></h3>
  57
  58       <p>Any browser that can be configured to use a proxy, which should be
  59       virtually all browsers, including <span class=
  60       "APPLICATION">Firefox</span>, <span class="APPLICATION">Internet
  61       Explorer</span>, <span class="APPLICATION">Opera</span>, and
  62       <span class="APPLICATION">Safari</span> among others. Direct browser
  63       support is not an absolute requirement since <span class=
  64       "APPLICATION">Privoxy</span> runs as a separate application and talks
  65       to the browser in the standardized HTTP protocol, just like a web
  66       server does.</p>
  67     </div>
  68
  69     <div class="SECT2">
  70       <h3 class="SECT2"><a name="WHICHOS" id="WHICHOS">2.2. Which operating
  71       systems are supported?</a></h3>
  72
  73       <p>At present, <span class="APPLICATION">Privoxy</span> is known to run
  74       on Windows(95, 98, ME, 2000, XP, Vista), GNU/Linux (RedHat, SuSE,
  75       Debian, Fedora, Gentoo, Slackware and others), Mac OSX, OS/2, AmigaOS,
  76       FreeBSD, NetBSD, OpenBSD, Solaris, and various other flavors of
  77       Unix.</p>
  78
  79       <p>But any operating system that runs TCP/IP, can conceivably take
  80       advantage of <span class="APPLICATION">Privoxy</span> in a networked
  81       situation where <span class="APPLICATION">Privoxy</span> would run as a
  82       server on a LAN gateway. Then only the <span class=
  83       "QUOTE">"gateway"</span> needs to be running one of the above operating
  84       systems.</p>
  85
  86       <p>Source code is freely available, so porting to other operating
  87       systems is always a possibility.</p>
  88     </div>
  89
  90     <div class="SECT2">
  91       <h3 class="SECT2"><a name="EMAIL-CLIENT" id="EMAIL-CLIENT">2.3. Can I
  92       use Privoxy with my email client?</a></h3>
  93
  94       <p>As long as there is some way to set a HTTP proxy for the client,
  95       then yes, any application can be used, whether it is strictly speaking
  96       a <span class="QUOTE">"browser"</span> or not. Though this may not be
  97       the best approach for dealing with some of the common abuses of HTML in
  98       email. See <a href="configuration.html#OUTLOOK">How can I configure
  99       <span class="APPLICATION">Privoxy</span> with <span class=
 100       "APPLICATION">Outlook</span>?</a> below for more on this.</p>
 101
 102       <p>Be aware that HTML email presents a number of unique security and
 103       privacy related issues, that can require advanced skills to overcome.
 104       The developers recommend using email clients that can be configured to
 105       convert HTML to plain text for these reasons.</p>
 106     </div>
 107
 108     <div class="SECT2">
 109       <h3 class="SECT2"><a name="FIRSTSTEP" id="FIRSTSTEP">2.4. I just
 110       installed Privoxy. Is there anything special I have to do now?</a></h3>
 111
 112       <p>All browsers should be told to use <span class=
 113       "APPLICATION">Privoxy</span> as a proxy by specifying the correct proxy
 114       address and port number in the appropriate configuration area for the
 115       browser. It's possible to combine <span class=
 116       "APPLICATION">Privoxy</span> with a packet filter to intercept HTTP
 117       requests even if the client isn't explicitly configured to use
 118       <span class="APPLICATION">Privoxy</span>, but where possible,
 119       configuring the client is recommended. See <a href=
 120       "../user-manual/startup.html" target="_top">the User Manual for more
 121       details</a>. You should also flush your browser's memory and disk cache
 122       to get rid of any cached junk items, and remove any stored <a href=
 123       "http://en.wikipedia.org/wiki/Browser_cookie" target=
 124       "_top">cookies</a>.</p>
 125     </div>
 126
 127     <div class="SECT2">
 128       <h3 class="SECT2"><a name="LOCALHOST" id="LOCALHOST">2.5. What is the
 129       proxy address of Privoxy?</a></h3>
 130
 131       <p>If you set up the <span class="APPLICATION">Privoxy</span> to run on
 132       the computer you browse from (rather than your ISP's server or some
 133       networked computer on a LAN), the proxy will be on <tt class=
 134       "LITERAL">127.0.0.1</tt> (sometimes referred to as <span class=
 135       "QUOTE">"localhost"</span>, which is the special name used by every
 136       computer on the Internet to refer to itself) and the port will be 8118
 137       (unless you used the <a href=
 138       "../user-manual/config.html#LISTEN-ADDRESS" target=
 139       "_top">listen-address</a> config option to tell <span class=
 140       "APPLICATION">Privoxy</span> to run on a different port).</p>
 141
 142       <p>When configuring your browser's proxy settings you typically enter
 143       the word <span class="QUOTE">"localhost"</span> or the IP address
 144       <span class="QUOTE">"127.0.0.1"</span> in the boxes next to
 145       <span class="QUOTE">"HTTP"</span> and <span class=
 146       "QUOTE">"Secure"</span> (HTTPS) and then the number <span class=
 147       "QUOTE">"8118"</span> for <span class="QUOTE">"port"</span>. This tells
 148       your browser to send all web requests to <span class=
 149       "APPLICATION">Privoxy</span> instead of directly to the Internet.</p>
 150
 151       <p><span class="APPLICATION">Privoxy</span> can also be used to proxy
 152       for a Local Area Network. In this case, your would enter either the IP
 153       address of the LAN host where <span class="APPLICATION">Privoxy</span>
 154       is running, or the equivalent hostname, e.g. <tt class=
 155       "LITERAL">192.168.1.1</tt>. Port assignment would be same as above.
 156       Note that <span class="APPLICATION">Privoxy</span> doesn't listen on
 157       any LAN interfaces by default.</p>
 158
 159       <p><span class="APPLICATION">Privoxy</span> does not currently handle
 160       any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc.</p>
 161     </div>
 162
 163     <div class="SECT2">
 164       <h3 class="SECT2"><a name="NOTHING" id="NOTHING">2.6. I just installed
 165       Privoxy, and nothing is happening. All the ads are there. What's
 166       wrong?</a></h3>
 167
 168       <p>Did you configure your browser to use <span class=
 169       "APPLICATION">Privoxy</span> as a proxy? It does not sound like it. See
 170       above. You might also try flushing the browser's caches to force a full
 171       re-reading of pages. You can verify that <span class=
 172       "APPLICATION">Privoxy</span> is running, and your browser is correctly
 173       configured by entering the special URL: <a href="http://p.p/" target=
 174       "_top">http://p.p/</a>. This should take you to a page titled
 175       <span class="QUOTE">"This is Privoxy.."</span> with access to
 176       <span class="APPLICATION">Privoxy's</span> internal configuration. If
 177       you see this, then you are good to go. If you receive a page saying
 178       <span class="QUOTE">"Privoxy is not running"</span>, then the browser
 179       is not set up to use your <span class="APPLICATION">Privoxy</span>
 180       installation. If you receive anything else (probably nothing at all),
 181       it could either be that the browser is not set up correctly, or that
 182       <span class="APPLICATION">Privoxy</span> is not running at all. Check
 183       the <a href="../user-manual/config.html#LOGFILE" target="_top">log
 184       file</a>. For instructions on starting <span class=
 185       "APPLICATION">Privoxy</span> and browser configuration, see the
 186       <a href="http://www.privoxy.org/user-manual/startup.html" target=
 187       "_top">chapter on starting <span class="APPLICATION">Privoxy</span></a>
 188       in the <a href="http://www.privoxy.org/user-manual/" target="_top">User
 189       Manual</a>.</p>
 190     </div>
 191
 192     <div class="SECT2">
 193       <h3 class="SECT2"><a name="NOTUSED" id="NOTUSED">2.7. I get a
 194       <span class="QUOTE">"Privoxy is not being used"</span> dummy page
 195       although Privoxy is running and being used.</a></h3>
 196
 197       <p>First, make sure that Privoxy is <span class=
 198       "emphasis EMPHASIS c2">really</span> running and being used by visiting
 199       <a href="http://p.p/" target="_top">http://p.p/</a>. You should see the
 200       <span class="APPLICATION">Privoxy</span> main page. If not, see the
 201       <a href="http://www.privoxy.org/user-manual/startup.html" target=
 202       "_top">chapter on starting <span class="APPLICATION">Privoxy</span></a>
 203       in the <a href="http://www.privoxy.org/user-manual/" target="_top">User
 204       Manual</a>.</p>
 205
 206       <p>Now if <a href="http://p.p/" target="_top">http://p.p/</a> works for
 207       you, but other parts of <span class="APPLICATION">Privoxy</span>'s web
 208       interface show the dummy page, your browser has cached a redirection it
 209       encountered before <span class="APPLICATION">Privoxy</span> was being
 210       used. You need to clear your browser's cache. Note that shift-reloading
 211       the dummy page won't help, since that'll only refresh the dummy page,
 212       not the redirection that lead you there.</p>
 213
 214       <p>The procedure for clearing the cache varies from browser to browser.
 215       For example, <span class="APPLICATION">Mozilla/Netscape</span> users
 216       would click <span class="GUIBUTTON">Edit</span> --&gt; <span class=
 217       "GUIBUTTON">Preferences</span> --&gt; <span class=
 218       "GUIBUTTON">Advanced</span> --&gt; <span class="GUIBUTTON">Cache</span>
 219       and then click both <span class="QUOTE">"<span class="GUIBUTTON">Clear
 220       Memory Cache</span>"</span> and <span class="QUOTE">"<span class=
 221       "GUIBUTTON">Clear Disk Cache</span>"</span>. In some <span class=
 222       "APPLICATION">Firefox</span> versions it's <span class=
 223       "GUIBUTTON">Tools</span> --&gt; <span class="GUIBUTTON">Options</span>
 224       --&gt; <span class="GUIBUTTON">Privacy</span> --&gt; <span class=
 225       "GUIBUTTON">Cache</span> and then click <span class=
 226       "QUOTE">"<span class="GUIBUTTON">Clear Cache Now</span>"</span>.</p>
 227     </div>
 228   </div>
 229
 230   <div class="NAVFOOTER">
 231     <hr class="c1" width="100%">
 232
 233     <table summary="Footer navigation table" width="100%" border="0"
 234     cellpadding="0" cellspacing="0">
 235       <tr>
 236         <td width="33%" align="left" valign="top"><a href="general.html"
 237         accesskey="P">Prev</a></td>
 238
 239         <td width="34%" align="center" valign="top"><a href="index.html"
 240         accesskey="H">Home</a></td>
 241
 242         <td width="33%" align="right" valign="top"><a href=
 243         "configuration.html" accesskey="N">Next</a></td>
 244       </tr>
 245
 246       <tr>
 247         <td width="33%" align="left" valign="top">General Information</td>
 248
 249         <td width="34%" align="center" valign="top">&nbsp;</td>
 250
 251         <td width="33%" align="right" valign="top">Configuration</td>
 252       </tr>
 253     </table>
 254   </div>
 255 </body>
 256 </html>