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="AEN263"
 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 below.
 235  You should also flush your browser's memory and disk cache to get rid of any
 236  cached junk items, and remove any stored
 237  <A
 238 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 239 TARGET="_top"
 240 >cookies</A
 241 >.&#13;</P
 242 ></DIV
 243 ><DIV
 244 CLASS="SECT2"
 245 ><H3
 246 CLASS="SECT2"
 247 ><A
 248 NAME="LOCALHOST"
 249 ></A
 250 >2.6. What is the proxy address of Privoxy?</H3
 251 ><P
 252 >  If you set up the <SPAN
 253 CLASS="APPLICATION"
 254 >Privoxy</SPAN
 255 > to run on
 256   the computer you browse from (rather than your ISP's server or some
 257   networked computer on a LAN), the proxy will be on <TT
 258 CLASS="LITERAL"
 259 >127.0.0.1</TT
 260 >
 261   (sometimes referred to as <SPAN
 262 CLASS="QUOTE"
 263 >"localhost"</SPAN
 264 >,
 265   which is the special name used by every computer on the Internet to refer
 266   to itself) and the port will be 8118 (unless you have <SPAN
 267 CLASS="APPLICATION"
 268 >Privoxy</SPAN
 269 >
 270   to run on a different port with the <A
 271 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 272 TARGET="_top"
 273 >listen-address</A
 274 > config option).
 275  </P
 276 ><P
 277 >  When configuring your browser's proxy settings you typically enter
 278   the word <SPAN
 279 CLASS="QUOTE"
 280 >"localhost"</SPAN
 281 > or the IP address <SPAN
 282 CLASS="QUOTE"
 283 >"127.0.0.1"</SPAN
 284 >
 285   in the boxes next to <SPAN
 286 CLASS="QUOTE"
 287 >"HTTP"</SPAN
 288 > and <SPAN
 289 CLASS="QUOTE"
 290 >"Secure"</SPAN
 291 > (HTTPS) and
 292   then the number <SPAN
 293 CLASS="QUOTE"
 294 >"8118"</SPAN
 295 > for <SPAN
 296 CLASS="QUOTE"
 297 >"port"</SPAN
 298 >.
 299   This tells your browser to send all web requests to <SPAN
 300 CLASS="APPLICATION"
 301 >Privoxy</SPAN
 302 >
 303   instead of directly to the Internet.
 304  </P
 305 ><P
 306 >  <SPAN
 307 CLASS="APPLICATION"
 308 >Privoxy</SPAN
 309 > can also be used to proxy for
 310   a Local Area Network. In this case, your would enter either the IP
 311   address of the LAN host where <SPAN
 312 CLASS="APPLICATION"
 313 >Privoxy</SPAN
 314 >
 315   is running, or the equivalent hostname. Port assignment would be
 316   same as above. Note that <SPAN
 317 CLASS="APPLICATION"
 318 >Privoxy</SPAN
 319 > doesn't
 320   listen on any LAN interfaces by default.
 321  </P
 322 ><P
 323 >  <SPAN
 324 CLASS="APPLICATION"
 325 >Privoxy</SPAN
 326 > does not currently handle
 327   any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. Be sure that
 328   proxying any of these other protocols is not activated.
 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 Privoxy, and nothing is happening.
 339 All the ads are there. What's wrong?</H3
 340 ><P
 341 > Did you configure your browser to use <SPAN
 342 CLASS="APPLICATION"
 343 >Privoxy</SPAN
 344 >
 345  as a proxy? It does not sound like it. See above. You might also try flushing
 346  the browser's caches to force a full re-reading of pages. You can verify
 347  that <SPAN
 348 CLASS="APPLICATION"
 349 >Privoxy</SPAN
 350 > is running, and your browser
 351  is correctly configured by entering the special URL:
 352  <A
 353 HREF="http://p.p/"
 354 TARGET="_top"
 355 >http://p.p/</A
 356 >.
 357
 358  This should take you to a page titled <SPAN
 359 CLASS="QUOTE"
 360 >"This is Privoxy.."</SPAN
 361 > with
 362  access to <SPAN
 363 CLASS="APPLICATION"
 364 >Privoxy's</SPAN
 365 > internal configuration.
 366  If you see this, then you are good to go. If you receive a page saying
 367  <SPAN
 368 CLASS="QUOTE"
 369 >"Privoxy is not running"</SPAN
 370 >, then the browser is not set up to use
 371  your <SPAN
 372 CLASS="APPLICATION"
 373 >Privoxy</SPAN
 374 > installation.
 375  If you receive anything else (probably nothing at all), it could either
 376  be that the browser is not set up correctly, or that
 377  <SPAN
 378 CLASS="APPLICATION"
 379 >Privoxy</SPAN
 380 > is not running at all. Check the <A
 381 HREF="../user-manual/config.html#LOGFILE"
 382 TARGET="_top"
 383 >log file</A
 384 >. For instructions
 385  on starting <SPAN
 386 CLASS="APPLICATION"
 387 >Privoxy</SPAN
 388 > and browser configuration,
 389  see the <A
 390 HREF="http://www.privoxy.org/user-manual/startup.html"
 391 TARGET="_top"
 392 >chapter
 393  on starting <SPAN
 394 CLASS="APPLICATION"
 395 >Privoxy</SPAN
 396 ></A
 397 > in the
 398  <A
 399 HREF="http://www.privoxy.org/user-manual/"
 400 TARGET="_top"
 401 >User Manual</A
 402 >.</P
 403 ></DIV
 404 ><DIV
 405 CLASS="SECT2"
 406 ><H3
 407 CLASS="SECT2"
 408 ><A
 409 NAME="NOTUSED"
 410 ></A
 411 >2.8. I get a <SPAN
 412 CLASS="QUOTE"
 413 >"Privoxy is not being used"</SPAN
 414 > dummy page although
 415 Privoxy is running and being used.</H3
 416 ><P
 417 > First, make sure that Privoxy is <SPAN
 418 CLASS="emphasis"
 419 ><I
 420 CLASS="EMPHASIS"
 421 >really</I
 422 ></SPAN
 423 > running and
 424  being used by visiting <A
 425 HREF="http://p.p/"
 426 TARGET="_top"
 427 >http://p.p/</A
 428 >. You
 429  should see the <SPAN
 430 CLASS="APPLICATION"
 431 >Privoxy</SPAN
 432 > main page. If not, see
 433  the <A
 434 HREF="http://www.privoxy.org/user-manual/startup.html"
 435 TARGET="_top"
 436 >chapter
 437  on starting <SPAN
 438 CLASS="APPLICATION"
 439 >Privoxy</SPAN
 440 ></A
 441 > in the
 442  <A
 443 HREF="http://www.privoxy.org/user-manual/"
 444 TARGET="_top"
 445 >User Manual</A
 446 >.</P
 447 ><P
 448 > Now if <A
 449 HREF="http://p.p/"
 450 TARGET="_top"
 451 >http://p.p/</A
 452 > works for you, but
 453  other parts of <SPAN
 454 CLASS="APPLICATION"
 455 >Privoxy</SPAN
 456 >'s web interface show
 457  the dummy page, your browser has cached a redirection it encountered before
 458  <SPAN
 459 CLASS="APPLICATION"
 460 >Privoxy</SPAN
 461 > was being used. You need to clear your
 462  browser's cache. Note that shift-reloading the dummy page won't help, since
 463  that'll only refresh the dummy page, not the redirection that lead you there.</P
 464 ><P
 465 > The procedure for clearing the cache varies from browser to browser. For
 466  example, <SPAN
 467 CLASS="APPLICATION"
 468 >Mozilla/Netscape</SPAN
 469 > users would click
 470  <SPAN
 471 CLASS="GUIBUTTON"
 472 >Edit</SPAN
 473 > --&#62; <SPAN
 474 CLASS="GUIBUTTON"
 475 >Preferences</SPAN
 476 > --&#62;
 477  <SPAN
 478 CLASS="GUIBUTTON"
 479 >Advanced</SPAN
 480 > --&#62; <SPAN
 481 CLASS="GUIBUTTON"
 482 >Cache</SPAN
 483 > and
 484  then click both <SPAN
 485 CLASS="QUOTE"
 486 >"<SPAN
 487 CLASS="GUIBUTTON"
 488 >Clear Memory Cache</SPAN
 489 >"</SPAN
 490 >
 491  and <SPAN
 492 CLASS="QUOTE"
 493 >"<SPAN
 494 CLASS="GUIBUTTON"
 495 >Clear Disk Cache</SPAN
 496 >"</SPAN
 497 >.
 498  And, <SPAN
 499 CLASS="APPLICATION"
 500 >Firefox</SPAN
 501 > users would click
 502  <SPAN
 503 CLASS="GUIBUTTON"
 504 >Tools</SPAN
 505 > --&#62; <SPAN
 506 CLASS="GUIBUTTON"
 507 >Options</SPAN
 508 > --&#62;
 509  <SPAN
 510 CLASS="GUIBUTTON"
 511 >Privacy</SPAN
 512 > --&#62; <SPAN
 513 CLASS="GUIBUTTON"
 514 >Cache</SPAN
 515 > and
 516  then click <SPAN
 517 CLASS="QUOTE"
 518 >"<SPAN
 519 CLASS="GUIBUTTON"
 520 >Clear Cache Now</SPAN
 521 >"</SPAN
 522 >.&#13;</P
 523 ></DIV
 524 ></DIV
 525 ><DIV
 526 CLASS="NAVFOOTER"
 527 ><HR
 528 ALIGN="LEFT"
 529 WIDTH="100%"><TABLE
 530 SUMMARY="Footer navigation table"
 531 WIDTH="100%"
 532 BORDER="0"
 533 CELLPADDING="0"
 534 CELLSPACING="0"
 535 ><TR
 536 ><TD
 537 WIDTH="33%"
 538 ALIGN="left"
 539 VALIGN="top"
 540 ><A
 541 HREF="general.html"
 542 ACCESSKEY="P"
 543 >Prev</A
 544 ></TD
 545 ><TD
 546 WIDTH="34%"
 547 ALIGN="center"
 548 VALIGN="top"
 549 ><A
 550 HREF="index.html"
 551 ACCESSKEY="H"
 552 >Home</A
 553 ></TD
 554 ><TD
 555 WIDTH="33%"
 556 ALIGN="right"
 557 VALIGN="top"
 558 ><A
 559 HREF="configuration.html"
 560 ACCESSKEY="N"
 561 >Next</A
 562 ></TD
 563 ></TR
 564 ><TR
 565 ><TD
 566 WIDTH="33%"
 567 ALIGN="left"
 568 VALIGN="top"
 569 >General Information</TD
 570 ><TD
 571 WIDTH="34%"
 572 ALIGN="center"
 573 VALIGN="top"
 574 >&nbsp;</TD
 575 ><TD
 576 WIDTH="33%"
 577 ALIGN="right"
 578 VALIGN="top"
 579 >Configuration</TD
 580 ></TR
 581 ></TABLE
 582 ></DIV
 583 ></BODY
 584 ></HTML
 585 >