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 must 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. See
 197  <A
 198 HREF="../user-manual/startup.html"
 199 TARGET="_top"
 200 >the User Manual for more
 201  details</A
 202 >. You should also flush your browser's memory and disk cache to get rid of any
 203  cached junk items, and remove any stored
 204  <A
 205 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 206 TARGET="_top"
 207 >cookies</A
 208 >.&#13;</P
 209 ></DIV
 210 ><DIV
 211 CLASS="SECT2"
 212 ><H3
 213 CLASS="SECT2"
 214 ><A
 215 NAME="LOCALHOST"
 216 >2.5. What is the proxy address of Privoxy?</A
 217 ></H3
 218 ><P
 219 >  If you set up the <SPAN
 220 CLASS="APPLICATION"
 221 >Privoxy</SPAN
 222 > to run on
 223   the computer you browse from (rather than your ISP's server or some
 224   networked computer on a LAN), the proxy will be on <TT
 225 CLASS="LITERAL"
 226 >127.0.0.1</TT
 227 >
 228   (sometimes referred to as <SPAN
 229 CLASS="QUOTE"
 230 >"localhost"</SPAN
 231 >,
 232   which is the special name used by every computer on the Internet to refer
 233   to itself) and the port will be 8118 (unless you have <SPAN
 234 CLASS="APPLICATION"
 235 >Privoxy</SPAN
 236 >
 237   to run on a different port with the <A
 238 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 239 TARGET="_top"
 240 >listen-address</A
 241 > config option).
 242  </P
 243 ><P
 244 >  When configuring your browser's proxy settings you typically enter
 245   the word <SPAN
 246 CLASS="QUOTE"
 247 >"localhost"</SPAN
 248 > or the IP address <SPAN
 249 CLASS="QUOTE"
 250 >"127.0.0.1"</SPAN
 251 >
 252   in the boxes next to <SPAN
 253 CLASS="QUOTE"
 254 >"HTTP"</SPAN
 255 > and <SPAN
 256 CLASS="QUOTE"
 257 >"Secure"</SPAN
 258 > (HTTPS) and
 259   then the number <SPAN
 260 CLASS="QUOTE"
 261 >"8118"</SPAN
 262 > for <SPAN
 263 CLASS="QUOTE"
 264 >"port"</SPAN
 265 >.
 266   This tells your browser to send all web requests to <SPAN
 267 CLASS="APPLICATION"
 268 >Privoxy</SPAN
 269 >
 270   instead of directly to the Internet.
 271  </P
 272 ><P
 273 >  <SPAN
 274 CLASS="APPLICATION"
 275 >Privoxy</SPAN
 276 > can also be used to proxy for
 277   a Local Area Network. In this case, your would enter either the IP
 278   address of the LAN host where <SPAN
 279 CLASS="APPLICATION"
 280 >Privoxy</SPAN
 281 >
 282   is running, or the equivalent hostname, e.g. <TT
 283 CLASS="LITERAL"
 284 >192.168.1.1</TT
 285 >.
 286   Port assignment would be same as above. Note that
 287   <SPAN
 288 CLASS="APPLICATION"
 289 >Privoxy</SPAN
 290 > doesn't listen on any LAN interfaces by
 291   default.
 292  </P
 293 ><P
 294 >  <SPAN
 295 CLASS="APPLICATION"
 296 >Privoxy</SPAN
 297 > does not currently handle
 298   any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. Be sure that
 299   proxying any of these other protocols is not activated.
 300  </P
 301 ></DIV
 302 ><DIV
 303 CLASS="SECT2"
 304 ><H3
 305 CLASS="SECT2"
 306 ><A
 307 NAME="NOTHING"
 308 >2.6. I just installed Privoxy, and nothing is happening.
 309 All the ads are there. What's wrong?</A
 310 ></H3
 311 ><P
 312 > Did you configure your browser to use <SPAN
 313 CLASS="APPLICATION"
 314 >Privoxy</SPAN
 315 >
 316  as a proxy? It does not sound like it. See above. You might also try flushing
 317  the browser's caches to force a full re-reading of pages. You can verify
 318  that <SPAN
 319 CLASS="APPLICATION"
 320 >Privoxy</SPAN
 321 > is running, and your browser
 322  is correctly configured by entering the special URL:
 323  <A
 324 HREF="http://p.p/"
 325 TARGET="_top"
 326 >http://p.p/</A
 327 >.
 328
 329  This should take you to a page titled <SPAN
 330 CLASS="QUOTE"
 331 >"This is Privoxy.."</SPAN
 332 > with
 333  access to <SPAN
 334 CLASS="APPLICATION"
 335 >Privoxy's</SPAN
 336 > internal configuration.
 337  If you see this, then you are good to go. If you receive a page saying
 338  <SPAN
 339 CLASS="QUOTE"
 340 >"Privoxy is not running"</SPAN
 341 >, then the browser is not set up to use
 342  your <SPAN
 343 CLASS="APPLICATION"
 344 >Privoxy</SPAN
 345 > installation.
 346  If you receive anything else (probably nothing at all), it could either
 347  be that the browser is not set up correctly, or that
 348  <SPAN
 349 CLASS="APPLICATION"
 350 >Privoxy</SPAN
 351 > is not running at all. Check the <A
 352 HREF="../user-manual/config.html#LOGFILE"
 353 TARGET="_top"
 354 >log file</A
 355 >. For instructions
 356  on starting <SPAN
 357 CLASS="APPLICATION"
 358 >Privoxy</SPAN
 359 > and browser configuration,
 360  see the <A
 361 HREF="http://www.privoxy.org/user-manual/startup.html"
 362 TARGET="_top"
 363 >chapter
 364  on starting <SPAN
 365 CLASS="APPLICATION"
 366 >Privoxy</SPAN
 367 ></A
 368 > in the
 369  <A
 370 HREF="http://www.privoxy.org/user-manual/"
 371 TARGET="_top"
 372 >User Manual</A
 373 >.</P
 374 ></DIV
 375 ><DIV
 376 CLASS="SECT2"
 377 ><H3
 378 CLASS="SECT2"
 379 ><A
 380 NAME="NOTUSED"
 381 >2.7. I get a <SPAN
 382 CLASS="QUOTE"
 383 >"Privoxy is not being used"</SPAN
 384 > dummy page although
 385 Privoxy is running and being used.</A
 386 ></H3
 387 ><P
 388 > First, make sure that Privoxy is <SPAN
 389 CLASS="emphasis"
 390 ><I
 391 CLASS="EMPHASIS"
 392 >really</I
 393 ></SPAN
 394 > running and
 395  being used by visiting <A
 396 HREF="http://p.p/"
 397 TARGET="_top"
 398 >http://p.p/</A
 399 >. You
 400  should see the <SPAN
 401 CLASS="APPLICATION"
 402 >Privoxy</SPAN
 403 > main page. If not, see
 404  the <A
 405 HREF="http://www.privoxy.org/user-manual/startup.html"
 406 TARGET="_top"
 407 >chapter
 408  on starting <SPAN
 409 CLASS="APPLICATION"
 410 >Privoxy</SPAN
 411 ></A
 412 > in the
 413  <A
 414 HREF="http://www.privoxy.org/user-manual/"
 415 TARGET="_top"
 416 >User Manual</A
 417 >.</P
 418 ><P
 419 > Now if <A
 420 HREF="http://p.p/"
 421 TARGET="_top"
 422 >http://p.p/</A
 423 > works for you, but
 424  other parts of <SPAN
 425 CLASS="APPLICATION"
 426 >Privoxy</SPAN
 427 >'s web interface show
 428  the dummy page, your browser has cached a redirection it encountered before
 429  <SPAN
 430 CLASS="APPLICATION"
 431 >Privoxy</SPAN
 432 > was being used. You need to clear your
 433  browser's cache. Note that shift-reloading the dummy page won't help, since
 434  that'll only refresh the dummy page, not the redirection that lead you there.</P
 435 ><P
 436 > The procedure for clearing the cache varies from browser to browser. For
 437  example, <SPAN
 438 CLASS="APPLICATION"
 439 >Mozilla/Netscape</SPAN
 440 > users would click
 441  <SPAN
 442 CLASS="GUIBUTTON"
 443 >Edit</SPAN
 444 > --&#62; <SPAN
 445 CLASS="GUIBUTTON"
 446 >Preferences</SPAN
 447 > --&#62;
 448  <SPAN
 449 CLASS="GUIBUTTON"
 450 >Advanced</SPAN
 451 > --&#62; <SPAN
 452 CLASS="GUIBUTTON"
 453 >Cache</SPAN
 454 > and
 455  then click both <SPAN
 456 CLASS="QUOTE"
 457 >"<SPAN
 458 CLASS="GUIBUTTON"
 459 >Clear Memory Cache</SPAN
 460 >"</SPAN
 461 >
 462  and <SPAN
 463 CLASS="QUOTE"
 464 >"<SPAN
 465 CLASS="GUIBUTTON"
 466 >Clear Disk Cache</SPAN
 467 >"</SPAN
 468 >.
 469  And, <SPAN
 470 CLASS="APPLICATION"
 471 >Firefox</SPAN
 472 > users would click
 473  <SPAN
 474 CLASS="GUIBUTTON"
 475 >Tools</SPAN
 476 > --&#62; <SPAN
 477 CLASS="GUIBUTTON"
 478 >Options</SPAN
 479 > --&#62;
 480  <SPAN
 481 CLASS="GUIBUTTON"
 482 >Privacy</SPAN
 483 > --&#62; <SPAN
 484 CLASS="GUIBUTTON"
 485 >Cache</SPAN
 486 > and
 487  then click <SPAN
 488 CLASS="QUOTE"
 489 >"<SPAN
 490 CLASS="GUIBUTTON"
 491 >Clear Cache Now</SPAN
 492 >"</SPAN
 493 >.&#13;</P
 494 ></DIV
 495 ></DIV
 496 ><DIV
 497 CLASS="NAVFOOTER"
 498 ><HR
 499 ALIGN="LEFT"
 500 WIDTH="100%"><TABLE
 501 SUMMARY="Footer navigation table"
 502 WIDTH="100%"
 503 BORDER="0"
 504 CELLPADDING="0"
 505 CELLSPACING="0"
 506 ><TR
 507 ><TD
 508 WIDTH="33%"
 509 ALIGN="left"
 510 VALIGN="top"
 511 ><A
 512 HREF="general.html"
 513 ACCESSKEY="P"
 514 >Prev</A
 515 ></TD
 516 ><TD
 517 WIDTH="34%"
 518 ALIGN="center"
 519 VALIGN="top"
 520 ><A
 521 HREF="index.html"
 522 ACCESSKEY="H"
 523 >Home</A
 524 ></TD
 525 ><TD
 526 WIDTH="33%"
 527 ALIGN="right"
 528 VALIGN="top"
 529 ><A
 530 HREF="configuration.html"
 531 ACCESSKEY="N"
 532 >Next</A
 533 ></TD
 534 ></TR
 535 ><TR
 536 ><TD
 537 WIDTH="33%"
 538 ALIGN="left"
 539 VALIGN="top"
 540 >General Information</TD
 541 ><TD
 542 WIDTH="34%"
 543 ALIGN="center"
 544 VALIGN="top"
 545 >&nbsp;</TD
 546 ><TD
 547 WIDTH="33%"
 548 ALIGN="right"
 549 VALIGN="top"
 550 >Configuration</TD
 551 ></TR
 552 ></TABLE
 553 ></DIV
 554 ></BODY
 555 ></HTML
 556 >