doc/webserver/faq/installation.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Installation</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><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 >2. Installation</A
  78 ></H1
  79 ><DIV
  80 CLASS="SECT2"
  81 ><H3
  82 CLASS="SECT2"
  83 ><A
  84 NAME="WHICHBROWSERS"
  85 >2.1. Which browsers are supported by <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy</SPAN
  88 >?</A
  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 >2.2. Which operating systems are supported?</A
 107 ></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, Conectiva, Gentoo,
 114  Slackware), Mac OSX, OS/2, AmigaOS, BeOS, FreeBSD, NetBSD, OpenBSD, Solaris,
 115  and many more 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 >2.3. Can I use <SPAN
 142 CLASS="APPLICATION"
 143 >Privoxy</SPAN
 144 > with my email client?</A
 145 ></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 >2.4. Can I install
 178  <SPAN
 179 CLASS="APPLICATION"
 180 >Privoxy</SPAN
 181 > over <SPAN
 182 CLASS="APPLICATION"
 183 >Junkbuster</SPAN
 184 >?</A
 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="AEN226"
 225 >2.5. I just installed <SPAN
 226 CLASS="APPLICATION"
 227 >Privoxy</SPAN
 228 >. Is there anything
 229 special I have to do now?</A
 230 ></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 >2.6. What is the proxy address of <SPAN
 248 CLASS="APPLICATION"
 249 >Privoxy</SPAN
 250 >?</A
 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 <VAR
 259 CLASS="LITERAL"
 260 >127.0.0.1</VAR
 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 >2.7. I just installed <SPAN
 338 CLASS="APPLICATION"
 339 >Privoxy</SPAN
 340 >, and nothing is happening.
 341 All the ads are there. What's wrong?</A
 342 ></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 >2.8. I get a <SPAN
 414 CLASS="QUOTE"
 415 >"Privoxy is not being used"</SPAN
 416 > dummy page although
 417 <SPAN
 418 CLASS="APPLICATION"
 419 >Privoxy</SPAN
 420 > is running and being used.</A
 421 ></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 >