File: installation.html

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