doc/webserver/faq/installation.html

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