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