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