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