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 Privoxy?</H3
  87 ><P
  88 > Any browser that can be configured to use a proxy, which
  89  should be virtually all browsers, including
  90  <SPAN
  91 CLASS="APPLICATION"
  92 >Firefox</SPAN
  93 >, <SPAN
  94 CLASS="APPLICATION"
  95 >Internet
  96  Explorer</SPAN
  97 >, and <SPAN
  98 CLASS="APPLICATION"
  99 >Opera</SPAN
 100 > among others.
 101  Direct browser support is not an absolute requirement since
 102  <SPAN
 103 CLASS="APPLICATION"
 104 >Privoxy</SPAN
 105 > runs as a separate application and talks
 106  to the browser in the standardized HTTP protocol, just like a web server
 107  does.</P
 108 ></DIV
 109 ><DIV
 110 CLASS="SECT2"
 111 ><H3
 112 CLASS="SECT2"
 113 ><A
 114 NAME="WHICHOS"
 115 ></A
 116 >2.2. Which operating systems are supported?</H3
 117 ><P
 118 > At present, <SPAN
 119 CLASS="APPLICATION"
 120 >Privoxy</SPAN
 121 > is known to run on
 122  Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Fedora, Gentoo,
 123  Slackware and others), Mac OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD,
 124  Solaris, and various other flavors of Unix.</P
 125 ><P
 126 > But any operating system that runs TCP/IP, can conceivably take advantage of
 127  <SPAN
 128 CLASS="APPLICATION"
 129 >Privoxy</SPAN
 130 > in a networked situation where
 131  <SPAN
 132 CLASS="APPLICATION"
 133 >Privoxy</SPAN
 134 > would run as a server on a LAN gateway.
 135  Then only the <SPAN
 136 CLASS="QUOTE"
 137 >"gateway"</SPAN
 138 > needs to be running one of the above
 139  operating systems.</P
 140 ><P
 141 > Source code is freely available, so porting to other operating systems
 142  is always a possibility.</P
 143 ></DIV
 144 ><DIV
 145 CLASS="SECT2"
 146 ><H3
 147 CLASS="SECT2"
 148 ><A
 149 NAME="EMAIL-CLIENT"
 150 ></A
 151 >2.3. Can I use Privoxy with my email client?</H3
 152 ><P
 153 > As long as there is some way to set a HTTP proxy for the client, then yes,
 154  any application can be used, whether it is strictly speaking a
 155  <SPAN
 156 CLASS="QUOTE"
 157 >"browser"</SPAN
 158 > or not. Though this may not be the best approach for
 159  dealing with some of the common abuses of HTML in email. See <A
 160 HREF="configuration.html#OUTLOOK"
 161 >How can I configure <SPAN
 162 CLASS="APPLICATION"
 163 >Privoxy</SPAN
 164 >
 165  with <SPAN
 166 CLASS="APPLICATION"
 167 >Outlook Express</SPAN
 168 >?</A
 169 > below for more on
 170  this. </P
 171 ><P
 172 > Be aware that HTML email presents a number of unique security and privacy
 173  related issues, that can require advanced skills to overcome. The developers
 174  recommend using email clients that can be configured to convert HTML to plain
 175  text for these reasons.</P
 176 ></DIV
 177 ><DIV
 178 CLASS="SECT2"
 179 ><H3
 180 CLASS="SECT2"
 181 ><A
 182 NAME="NEWINSTALL"
 183 ></A
 184 >2.4. Can I install
 185  Privoxy over Junkbuster?</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="FIRSTSTEP"
 225 ></A
 226 >2.5. I just installed Privoxy. Is there anything
 227 special I have to do now?</H3
 228 ><P
 229 > All browsers must be told to use <SPAN
 230 CLASS="APPLICATION"
 231 >Privoxy</SPAN
 232 >
 233  as a proxy by specifying the correct proxy address and port number
 234  in the appropriate configuration area for the browser. See
 235  <A
 236 HREF="../user-manual/startup.html"
 237 TARGET="_top"
 238 >the User Manual for more
 239  details</A
 240 >. You should also flush your browser's memory and disk cache to get rid of any
 241  cached junk items, and remove any stored
 242  <A
 243 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 244 TARGET="_top"
 245 >cookies</A
 246 >.&#13;</P
 247 ></DIV
 248 ><DIV
 249 CLASS="SECT2"
 250 ><H3
 251 CLASS="SECT2"
 252 ><A
 253 NAME="LOCALHOST"
 254 ></A
 255 >2.6. What is the proxy address of Privoxy?</H3
 256 ><P
 257 >  If you set up the <SPAN
 258 CLASS="APPLICATION"
 259 >Privoxy</SPAN
 260 > to run on
 261   the computer you browse from (rather than your ISP's server or some
 262   networked computer on a LAN), the proxy will be on <TT
 263 CLASS="LITERAL"
 264 >127.0.0.1</TT
 265 >
 266   (sometimes referred to as <SPAN
 267 CLASS="QUOTE"
 268 >"localhost"</SPAN
 269 >,
 270   which is the special name used by every computer on the Internet to refer
 271   to itself) and the port will be 8118 (unless you have <SPAN
 272 CLASS="APPLICATION"
 273 >Privoxy</SPAN
 274 >
 275   to run on a different port with the <A
 276 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 277 TARGET="_top"
 278 >listen-address</A
 279 > config option).
 280  </P
 281 ><P
 282 >  When configuring your browser's proxy settings you typically enter
 283   the word <SPAN
 284 CLASS="QUOTE"
 285 >"localhost"</SPAN
 286 > or the IP address <SPAN
 287 CLASS="QUOTE"
 288 >"127.0.0.1"</SPAN
 289 >
 290   in the boxes next to <SPAN
 291 CLASS="QUOTE"
 292 >"HTTP"</SPAN
 293 > and <SPAN
 294 CLASS="QUOTE"
 295 >"Secure"</SPAN
 296 > (HTTPS) and
 297   then the number <SPAN
 298 CLASS="QUOTE"
 299 >"8118"</SPAN
 300 > for <SPAN
 301 CLASS="QUOTE"
 302 >"port"</SPAN
 303 >.
 304   This tells your browser to send all web requests to <SPAN
 305 CLASS="APPLICATION"
 306 >Privoxy</SPAN
 307 >
 308   instead of directly to the Internet.
 309  </P
 310 ><P
 311 >  <SPAN
 312 CLASS="APPLICATION"
 313 >Privoxy</SPAN
 314 > can also be used to proxy for
 315   a Local Area Network. In this case, your would enter either the IP
 316   address of the LAN host where <SPAN
 317 CLASS="APPLICATION"
 318 >Privoxy</SPAN
 319 >
 320   is running, or the equivalent hostname, e.g. <TT
 321 CLASS="LITERAL"
 322 >192.168.1.1</TT
 323 >.
 324   Port assignment would be same as above. Note that
 325   <SPAN
 326 CLASS="APPLICATION"
 327 >Privoxy</SPAN
 328 > doesn't listen on any LAN interfaces by
 329   default.
 330  </P
 331 ><P
 332 >  <SPAN
 333 CLASS="APPLICATION"
 334 >Privoxy</SPAN
 335 > does not currently handle
 336   any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. Be sure that
 337   proxying any of these other protocols is not activated.
 338  </P
 339 ></DIV
 340 ><DIV
 341 CLASS="SECT2"
 342 ><H3
 343 CLASS="SECT2"
 344 ><A
 345 NAME="NOTHING"
 346 ></A
 347 >2.7. I just installed Privoxy, and nothing is happening.
 348 All the ads are there. What's wrong?</H3
 349 ><P
 350 > Did you configure your browser to use <SPAN
 351 CLASS="APPLICATION"
 352 >Privoxy</SPAN
 353 >
 354  as a proxy? It does not sound like it. See above. You might also try flushing
 355  the browser's caches to force a full re-reading of pages. You can verify
 356  that <SPAN
 357 CLASS="APPLICATION"
 358 >Privoxy</SPAN
 359 > is running, and your browser
 360  is correctly configured by entering the special URL:
 361  <A
 362 HREF="http://p.p/"
 363 TARGET="_top"
 364 >http://p.p/</A
 365 >.
 366
 367  This should take you to a page titled <SPAN
 368 CLASS="QUOTE"
 369 >"This is Privoxy.."</SPAN
 370 > with
 371  access to <SPAN
 372 CLASS="APPLICATION"
 373 >Privoxy's</SPAN
 374 > internal configuration.
 375  If you see this, then you are good to go. If you receive a page saying
 376  <SPAN
 377 CLASS="QUOTE"
 378 >"Privoxy is not running"</SPAN
 379 >, then the browser is not set up to use
 380  your <SPAN
 381 CLASS="APPLICATION"
 382 >Privoxy</SPAN
 383 > installation.
 384  If you receive anything else (probably nothing at all), it could either
 385  be that the browser is not set up correctly, or that
 386  <SPAN
 387 CLASS="APPLICATION"
 388 >Privoxy</SPAN
 389 > is not running at all. Check the <A
 390 HREF="../user-manual/config.html#LOGFILE"
 391 TARGET="_top"
 392 >log file</A
 393 >. For instructions
 394  on starting <SPAN
 395 CLASS="APPLICATION"
 396 >Privoxy</SPAN
 397 > and browser configuration,
 398  see the <A
 399 HREF="http://www.privoxy.org/user-manual/startup.html"
 400 TARGET="_top"
 401 >chapter
 402  on starting <SPAN
 403 CLASS="APPLICATION"
 404 >Privoxy</SPAN
 405 ></A
 406 > in the
 407  <A
 408 HREF="http://www.privoxy.org/user-manual/"
 409 TARGET="_top"
 410 >User Manual</A
 411 >.</P
 412 ></DIV
 413 ><DIV
 414 CLASS="SECT2"
 415 ><H3
 416 CLASS="SECT2"
 417 ><A
 418 NAME="NOTUSED"
 419 ></A
 420 >2.8. I get a <SPAN
 421 CLASS="QUOTE"
 422 >"Privoxy is not being used"</SPAN
 423 > dummy page although
 424 Privoxy is running and being used.</H3
 425 ><P
 426 > First, make sure that Privoxy is <SPAN
 427 CLASS="emphasis"
 428 ><I
 429 CLASS="EMPHASIS"
 430 >really</I
 431 ></SPAN
 432 > running and
 433  being used by visiting <A
 434 HREF="http://p.p/"
 435 TARGET="_top"
 436 >http://p.p/</A
 437 >. You
 438  should see the <SPAN
 439 CLASS="APPLICATION"
 440 >Privoxy</SPAN
 441 > main page. If not, see
 442  the <A
 443 HREF="http://www.privoxy.org/user-manual/startup.html"
 444 TARGET="_top"
 445 >chapter
 446  on starting <SPAN
 447 CLASS="APPLICATION"
 448 >Privoxy</SPAN
 449 ></A
 450 > in the
 451  <A
 452 HREF="http://www.privoxy.org/user-manual/"
 453 TARGET="_top"
 454 >User Manual</A
 455 >.</P
 456 ><P
 457 > Now if <A
 458 HREF="http://p.p/"
 459 TARGET="_top"
 460 >http://p.p/</A
 461 > works for you, but
 462  other parts of <SPAN
 463 CLASS="APPLICATION"
 464 >Privoxy</SPAN
 465 >'s web interface show
 466  the dummy page, your browser has cached a redirection it encountered before
 467  <SPAN
 468 CLASS="APPLICATION"
 469 >Privoxy</SPAN
 470 > was being used. You need to clear your
 471  browser's cache. Note that shift-reloading the dummy page won't help, since
 472  that'll only refresh the dummy page, not the redirection that lead you there.</P
 473 ><P
 474 > The procedure for clearing the cache varies from browser to browser. For
 475  example, <SPAN
 476 CLASS="APPLICATION"
 477 >Mozilla/Netscape</SPAN
 478 > users would click
 479  <SPAN
 480 CLASS="GUIBUTTON"
 481 >Edit</SPAN
 482 > --&#62; <SPAN
 483 CLASS="GUIBUTTON"
 484 >Preferences</SPAN
 485 > --&#62;
 486  <SPAN
 487 CLASS="GUIBUTTON"
 488 >Advanced</SPAN
 489 > --&#62; <SPAN
 490 CLASS="GUIBUTTON"
 491 >Cache</SPAN
 492 > and
 493  then click both <SPAN
 494 CLASS="QUOTE"
 495 >"<SPAN
 496 CLASS="GUIBUTTON"
 497 >Clear Memory Cache</SPAN
 498 >"</SPAN
 499 >
 500  and <SPAN
 501 CLASS="QUOTE"
 502 >"<SPAN
 503 CLASS="GUIBUTTON"
 504 >Clear Disk Cache</SPAN
 505 >"</SPAN
 506 >.
 507  And, <SPAN
 508 CLASS="APPLICATION"
 509 >Firefox</SPAN
 510 > users would click
 511  <SPAN
 512 CLASS="GUIBUTTON"
 513 >Tools</SPAN
 514 > --&#62; <SPAN
 515 CLASS="GUIBUTTON"
 516 >Options</SPAN
 517 > --&#62;
 518  <SPAN
 519 CLASS="GUIBUTTON"
 520 >Privacy</SPAN
 521 > --&#62; <SPAN
 522 CLASS="GUIBUTTON"
 523 >Cache</SPAN
 524 > and
 525  then click <SPAN
 526 CLASS="QUOTE"
 527 >"<SPAN
 528 CLASS="GUIBUTTON"
 529 >Clear Cache Now</SPAN
 530 >"</SPAN
 531 >.&#13;</P
 532 ></DIV
 533 ></DIV
 534 ><DIV
 535 CLASS="NAVFOOTER"
 536 ><HR
 537 ALIGN="LEFT"
 538 WIDTH="100%"><TABLE
 539 SUMMARY="Footer navigation table"
 540 WIDTH="100%"
 541 BORDER="0"
 542 CELLPADDING="0"
 543 CELLSPACING="0"
 544 ><TR
 545 ><TD
 546 WIDTH="33%"
 547 ALIGN="left"
 548 VALIGN="top"
 549 ><A
 550 HREF="general.html"
 551 ACCESSKEY="P"
 552 >Prev</A
 553 ></TD
 554 ><TD
 555 WIDTH="34%"
 556 ALIGN="center"
 557 VALIGN="top"
 558 ><A
 559 HREF="index.html"
 560 ACCESSKEY="H"
 561 >Home</A
 562 ></TD
 563 ><TD
 564 WIDTH="33%"
 565 ALIGN="right"
 566 VALIGN="top"
 567 ><A
 568 HREF="configuration.html"
 569 ACCESSKEY="N"
 570 >Next</A
 571 ></TD
 572 ></TR
 573 ><TR
 574 ><TD
 575 WIDTH="33%"
 576 ALIGN="left"
 577 VALIGN="top"
 578 >General Information</TD
 579 ><TD
 580 WIDTH="34%"
 581 ALIGN="center"
 582 VALIGN="top"
 583 >&nbsp;</TD
 584 ><TD
 585 WIDTH="33%"
 586 ALIGN="right"
 587 VALIGN="top"
 588 >Configuration</TD
 589 ></TR
 590 ></TABLE
 591 ></DIV
 592 ></BODY
 593 ></HTML
 594 >