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