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