doc/webserver/faq/installation.html

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