Bump generated Firefox version to 3.6.15.
[privoxy.git] / doc / webserver / faq / installation.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Installation</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Privoxy Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="General Information"
14 HREF="general.html"><LINK
15 REL="NEXT"
16 TITLE="Configuration"
17 HREF="configuration.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1"></HEAD
24 ><BODY
25 CLASS="SECT1"
26 BGCOLOR="#EEEEEE"
27 TEXT="#000000"
28 LINK="#0000FF"
29 VLINK="#840084"
30 ALINK="#0000FF"
31 ><DIV
32 CLASS="NAVHEADER"
33 ><TABLE
34 SUMMARY="Header navigation table"
35 WIDTH="100%"
36 BORDER="0"
37 CELLPADDING="0"
38 CELLSPACING="0"
39 ><TR
40 ><TH
41 COLSPAN="3"
42 ALIGN="center"
43 >Privoxy Frequently Asked Questions</TH
44 ></TR
45 ><TR
46 ><TD
47 WIDTH="10%"
48 ALIGN="left"
49 VALIGN="bottom"
50 ><A
51 HREF="general.html"
52 ACCESSKEY="P"
53 >Prev</A
54 ></TD
55 ><TD
56 WIDTH="80%"
57 ALIGN="center"
58 VALIGN="bottom"
59 ></TD
60 ><TD
61 WIDTH="10%"
62 ALIGN="right"
63 VALIGN="bottom"
64 ><A
65 HREF="configuration.html"
66 ACCESSKEY="N"
67 >Next</A
68 ></TD
69 ></TR
70 ></TABLE
71 ><HR
72 ALIGN="LEFT"
73 WIDTH="100%"></DIV
74 ><DIV
75 CLASS="SECT1"
76 ><H1
77 CLASS="SECT1"
78 ><A
79 NAME="INSTALLATION"
80 >2. Installation</A
81 ></H1
82 ><DIV
83 CLASS="SECT2"
84 ><H3
85 CLASS="SECT2"
86 ><A
87 NAME="WHICHBROWSERS"
88 >2.1. Which browsers are supported by Privoxy?</A
89 ></H3
90 ><P
91 > Any browser that can be configured to use a proxy, which 
92  should be virtually all browsers, including
93  <SPAN
94 CLASS="APPLICATION"
95 >Firefox</SPAN
96 >, <SPAN
97 CLASS="APPLICATION"
98 >Internet
99  Explorer</SPAN
100 >, <SPAN
101 CLASS="APPLICATION"
102 >Opera</SPAN
103 >, and 
104  <SPAN
105 CLASS="APPLICATION"
106 >Safari</SPAN
107 > among others.
108  Direct browser support is not an absolute requirement since
109  <SPAN
110 CLASS="APPLICATION"
111 >Privoxy</SPAN
112 > runs as a separate application and talks
113  to the browser in the standardized HTTP protocol, just like a web server
114  does.</P
115 ></DIV
116 ><DIV
117 CLASS="SECT2"
118 ><H3
119 CLASS="SECT2"
120 ><A
121 NAME="WHICHOS"
122 >2.2. Which operating systems are supported?</A
123 ></H3
124 ><P
125 > At present, <SPAN
126 CLASS="APPLICATION"
127 >Privoxy</SPAN
128 > is known to run on
129  Windows(95, 98, ME, 2000, XP, Vista), GNU/Linux (RedHat, SuSE, Debian,
130  Fedora, Gentoo, Slackware and others), Mac OSX, OS/2, AmigaOS, FreeBSD,
131  NetBSD, OpenBSD, Solaris, and various other flavors of Unix.</P
132 ><P
133 > But any operating system that runs TCP/IP, can conceivably take advantage of
134  <SPAN
135 CLASS="APPLICATION"
136 >Privoxy</SPAN
137 > in a networked situation where
138  <SPAN
139 CLASS="APPLICATION"
140 >Privoxy</SPAN
141 > would run as a server on a LAN gateway. 
142  Then only the <SPAN
143 CLASS="QUOTE"
144 >"gateway"</SPAN
145 > needs to be running one of the above
146  operating systems.</P
147 ><P
148 > Source code is freely available, so porting to other operating systems 
149  is always a possibility.</P
150 ></DIV
151 ><DIV
152 CLASS="SECT2"
153 ><H3
154 CLASS="SECT2"
155 ><A
156 NAME="EMAIL-CLIENT"
157 >2.3. Can I use Privoxy with my email client?</A
158 ></H3
159 ><P
160 > As long as there is some way to set a HTTP proxy for the client, then yes,
161  any application can be used, whether it is strictly speaking a
162  <SPAN
163 CLASS="QUOTE"
164 >"browser"</SPAN
165 > or not. Though this may not be the best approach for
166  dealing with some of the common abuses of HTML in email. See <A
167 HREF="configuration.html#OUTLOOK"
168 >How can I configure <SPAN
169 CLASS="APPLICATION"
170 >Privoxy</SPAN
171 >
172  with <SPAN
173 CLASS="APPLICATION"
174 >Outlook</SPAN
175 >?</A
176 > below for more on
177  this. </P
178 ><P
179 > Be aware that HTML email presents a number of unique security and privacy
180  related issues, that can require advanced skills to overcome. The developers
181  recommend using email clients that can be configured to convert HTML to plain
182  text for these reasons.</P
183 ></DIV
184 ><DIV
185 CLASS="SECT2"
186 ><H3
187 CLASS="SECT2"
188 ><A
189 NAME="FIRSTSTEP"
190 >2.4. I just installed Privoxy. Is there anything 
191 special I have to do now?</A
192 ></H3
193 ><P
194 > All browsers should be told to use <SPAN
195 CLASS="APPLICATION"
196 >Privoxy</SPAN
197
198  as a proxy by specifying the correct proxy address and port number 
199  in the appropriate configuration area for the browser. It's possible
200  to combine <SPAN
201 CLASS="APPLICATION"
202 >Privoxy</SPAN
203 > with a packet filter to intercept HTTP requests
204  even if the client isn't explicitly configured to use <SPAN
205 CLASS="APPLICATION"
206 >Privoxy</SPAN
207 >,
208  but where possible, configuring the client is recommended. See 
209  <A
210 HREF="../user-manual/startup.html"
211 TARGET="_top"
212 >the User Manual for more
213  details</A
214 >. You should also flush your browser's memory and disk
215  cache to get rid of any cached junk items, and remove any stored 
216  <A
217 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
218 TARGET="_top"
219 >cookies</A
220 >.&#13;</P
221 ></DIV
222 ><DIV
223 CLASS="SECT2"
224 ><H3
225 CLASS="SECT2"
226 ><A
227 NAME="LOCALHOST"
228 >2.5. What is the proxy address of Privoxy?</A
229 ></H3
230 ><P
231 >  If you set up the <SPAN
232 CLASS="APPLICATION"
233 >Privoxy</SPAN
234 > to run on
235   the computer you browse from (rather than your ISP's server or some
236   networked computer on a LAN), the proxy will be on <TT
237 CLASS="LITERAL"
238 >127.0.0.1</TT
239
240   (sometimes referred to as <SPAN
241 CLASS="QUOTE"
242 >"localhost"</SPAN
243 >,
244   which is the special name used by every computer on the Internet to refer
245   to itself) and the port will be 8118 (unless you used the <A
246 HREF="../user-manual/config.html#LISTEN-ADDRESS"
247 TARGET="_top"
248 >listen-address</A
249 >
250   config option to tell <SPAN
251 CLASS="APPLICATION"
252 >Privoxy</SPAN
253 > to run on
254   a different port).
255  </P
256 ><P
257 >  When configuring your browser's proxy settings you typically enter
258   the word <SPAN
259 CLASS="QUOTE"
260 >"localhost"</SPAN
261 > or the IP address <SPAN
262 CLASS="QUOTE"
263 >"127.0.0.1"</SPAN
264 >
265   in the boxes next to <SPAN
266 CLASS="QUOTE"
267 >"HTTP"</SPAN
268 > and <SPAN
269 CLASS="QUOTE"
270 >"Secure"</SPAN
271 > (HTTPS) and
272   then the number <SPAN
273 CLASS="QUOTE"
274 >"8118"</SPAN
275 > for <SPAN
276 CLASS="QUOTE"
277 >"port"</SPAN
278 >. 
279   This tells your browser to send all web requests to <SPAN
280 CLASS="APPLICATION"
281 >Privoxy</SPAN
282 >
283   instead of directly to the Internet.
284  </P
285 ><P
286 >  <SPAN
287 CLASS="APPLICATION"
288 >Privoxy</SPAN
289 > can also be used to proxy for 
290   a Local Area Network. In this case, your would enter either the IP 
291   address of the LAN host where <SPAN
292 CLASS="APPLICATION"
293 >Privoxy</SPAN
294
295   is running, or the equivalent hostname, e.g. <TT
296 CLASS="LITERAL"
297 >192.168.1.1</TT
298 >.
299   Port assignment would be same as above. Note that
300   <SPAN
301 CLASS="APPLICATION"
302 >Privoxy</SPAN
303 > doesn't listen on any LAN interfaces by
304   default.
305  </P
306 ><P
307 >  <SPAN
308 CLASS="APPLICATION"
309 >Privoxy</SPAN
310 > does not currently handle
311   any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc.
312  </P
313 ></DIV
314 ><DIV
315 CLASS="SECT2"
316 ><H3
317 CLASS="SECT2"
318 ><A
319 NAME="NOTHING"
320 >2.6. I just installed Privoxy, and nothing is happening.
321 All the ads are there. What's wrong?</A
322 ></H3
323 ><P
324 > Did you configure your browser to use <SPAN
325 CLASS="APPLICATION"
326 >Privoxy</SPAN
327
328  as a proxy? It does not sound like it. See above. You might also try flushing
329  the browser's caches to force a full re-reading of pages. You can verify 
330  that <SPAN
331 CLASS="APPLICATION"
332 >Privoxy</SPAN
333 > is running, and your browser 
334  is correctly configured by entering the special URL: 
335  <A
336 HREF="http://p.p/"
337 TARGET="_top"
338 >http://p.p/</A
339 >. 
340  
341  This should take you to a page titled <SPAN
342 CLASS="QUOTE"
343 >"This is Privoxy.."</SPAN
344 > with
345  access to <SPAN
346 CLASS="APPLICATION"
347 >Privoxy's</SPAN
348 > internal configuration.
349  If you see this, then you are good to go. If you receive a page saying 
350  <SPAN
351 CLASS="QUOTE"
352 >"Privoxy is not running"</SPAN
353 >, then the browser is not set up to use
354  your <SPAN
355 CLASS="APPLICATION"
356 >Privoxy</SPAN
357 > installation.
358  If you receive anything else (probably nothing at all), it could either
359  be that the browser is not set up correctly, or that
360  <SPAN
361 CLASS="APPLICATION"
362 >Privoxy</SPAN
363 > is not running at all. Check the <A
364 HREF="../user-manual/config.html#LOGFILE"
365 TARGET="_top"
366 >log file</A
367 >. For instructions
368  on starting <SPAN
369 CLASS="APPLICATION"
370 >Privoxy</SPAN
371 > and browser configuration,
372  see the <A
373 HREF="http://www.privoxy.org/user-manual/startup.html"
374 TARGET="_top"
375 >chapter
376  on starting <SPAN
377 CLASS="APPLICATION"
378 >Privoxy</SPAN
379 ></A
380 > in the
381  <A
382 HREF="http://www.privoxy.org/user-manual/"
383 TARGET="_top"
384 >User Manual</A
385 >.</P
386 ></DIV
387 ><DIV
388 CLASS="SECT2"
389 ><H3
390 CLASS="SECT2"
391 ><A
392 NAME="NOTUSED"
393 >2.7. I get a <SPAN
394 CLASS="QUOTE"
395 >"Privoxy is not being used"</SPAN
396 > dummy page although
397 Privoxy is running and being used.</A
398 ></H3
399 ><P
400 > First, make sure that Privoxy is <SPAN
401 CLASS="emphasis"
402 ><I
403 CLASS="EMPHASIS"
404 >really</I
405 ></SPAN
406 > running and
407  being used by visiting <A
408 HREF="http://p.p/"
409 TARGET="_top"
410 >http://p.p/</A
411 >. You
412  should see the <SPAN
413 CLASS="APPLICATION"
414 >Privoxy</SPAN
415 > main page. If not, see
416  the <A
417 HREF="http://www.privoxy.org/user-manual/startup.html"
418 TARGET="_top"
419 >chapter
420  on starting <SPAN
421 CLASS="APPLICATION"
422 >Privoxy</SPAN
423 ></A
424 > in the
425  <A
426 HREF="http://www.privoxy.org/user-manual/"
427 TARGET="_top"
428 >User Manual</A
429 >.</P
430 ><P
431 > Now if <A
432 HREF="http://p.p/"
433 TARGET="_top"
434 >http://p.p/</A
435 > works for you, but
436  other parts of <SPAN
437 CLASS="APPLICATION"
438 >Privoxy</SPAN
439 >'s web interface show
440  the dummy page, your browser has cached a redirection it encountered before
441  <SPAN
442 CLASS="APPLICATION"
443 >Privoxy</SPAN
444 > was being used. You need to clear your
445  browser's cache. Note that shift-reloading the dummy page won't help, since
446  that'll only refresh the dummy page, not the redirection that lead you there.</P
447 ><P
448 > The procedure for clearing the cache varies from browser to browser. For
449  example, <SPAN
450 CLASS="APPLICATION"
451 >Mozilla/Netscape</SPAN
452 > users would click 
453  <SPAN
454 CLASS="GUIBUTTON"
455 >Edit</SPAN
456 > --&#62; <SPAN
457 CLASS="GUIBUTTON"
458 >Preferences</SPAN
459 > --&#62;
460  <SPAN
461 CLASS="GUIBUTTON"
462 >Advanced</SPAN
463 > --&#62; <SPAN
464 CLASS="GUIBUTTON"
465 >Cache</SPAN
466 > and
467  then click both <SPAN
468 CLASS="QUOTE"
469 >"<SPAN
470 CLASS="GUIBUTTON"
471 >Clear Memory Cache</SPAN
472 >"</SPAN
473 >
474  and <SPAN
475 CLASS="QUOTE"
476 >"<SPAN
477 CLASS="GUIBUTTON"
478 >Clear Disk Cache</SPAN
479 >"</SPAN
480 >.
481  In some <SPAN
482 CLASS="APPLICATION"
483 >Firefox</SPAN
484 > versions it's
485  <SPAN
486 CLASS="GUIBUTTON"
487 >Tools</SPAN
488 > --&#62; <SPAN
489 CLASS="GUIBUTTON"
490 >Options</SPAN
491 > --&#62;
492  <SPAN
493 CLASS="GUIBUTTON"
494 >Privacy</SPAN
495 > --&#62; <SPAN
496 CLASS="GUIBUTTON"
497 >Cache</SPAN
498 > and
499  then click <SPAN
500 CLASS="QUOTE"
501 >"<SPAN
502 CLASS="GUIBUTTON"
503 >Clear Cache Now</SPAN
504 >"</SPAN
505 >.
506  </P
507 ></DIV
508 ></DIV
509 ><DIV
510 CLASS="NAVFOOTER"
511 ><HR
512 ALIGN="LEFT"
513 WIDTH="100%"><TABLE
514 SUMMARY="Footer navigation table"
515 WIDTH="100%"
516 BORDER="0"
517 CELLPADDING="0"
518 CELLSPACING="0"
519 ><TR
520 ><TD
521 WIDTH="33%"
522 ALIGN="left"
523 VALIGN="top"
524 ><A
525 HREF="general.html"
526 ACCESSKEY="P"
527 >Prev</A
528 ></TD
529 ><TD
530 WIDTH="34%"
531 ALIGN="center"
532 VALIGN="top"
533 ><A
534 HREF="index.html"
535 ACCESSKEY="H"
536 >Home</A
537 ></TD
538 ><TD
539 WIDTH="33%"
540 ALIGN="right"
541 VALIGN="top"
542 ><A
543 HREF="configuration.html"
544 ACCESSKEY="N"
545 >Next</A
546 ></TD
547 ></TR
548 ><TR
549 ><TD
550 WIDTH="33%"
551 ALIGN="left"
552 VALIGN="top"
553 >General Information</TD
554 ><TD
555 WIDTH="34%"
556 ALIGN="center"
557 VALIGN="top"
558 >&nbsp;</TD
559 ><TD
560 WIDTH="33%"
561 ALIGN="right"
562 VALIGN="top"
563 >Configuration</TD
564 ></TR
565 ></TABLE
566 ></DIV
567 ></BODY
568 ></HTML
569 >