doc/webserver/faq/installation.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Installation</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   8 "><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 ></A
  78 >2. Installation</H1
  79 ><DIV
  80 CLASS="SECT2"
  81 ><H3
  82 CLASS="SECT2"
  83 ><A
  84 NAME="WHICHBROWSERS"
  85 ></A
  86 >2.1. Which browsers are supported by <SPAN
  87 CLASS="APPLICATION"
  88 >Privoxy</SPAN
  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 ></A
 107 >2.2. Which operating systems are supported?</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 ></A
 142 >2.3. Can I use <SPAN
 143 CLASS="APPLICATION"
 144 >Privoxy</SPAN
 145 > with my email client?</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 ></A
 178 >2.4. Can I install
 179  <SPAN
 180 CLASS="APPLICATION"
 181 >Privoxy</SPAN
 182 > over <SPAN
 183 CLASS="APPLICATION"
 184 >Junkbuster</SPAN
 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="AEN218"
 225 ></A
 226 >2.5. I just installed <SPAN
 227 CLASS="APPLICATION"
 228 >Privoxy</SPAN
 229 >. Is there anything
 230 special I have to do now?</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 ></A
 248 >2.6. What is the proxy address of <SPAN
 249 CLASS="APPLICATION"
 250 >Privoxy</SPAN
 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 <TT
 259 CLASS="LITERAL"
 260 >127.0.0.1</TT
 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   protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
 329   protocols.
 330  </P
 331 ></DIV
 332 ><DIV
 333 CLASS="SECT2"
 334 ><H3
 335 CLASS="SECT2"
 336 ><A
 337 NAME="NOTHING"
 338 ></A
 339 >2.7. I just installed <SPAN
 340 CLASS="APPLICATION"
 341 >Privoxy</SPAN
 342 >, and nothing is happening.
 343 All the ads are there. What's wrong?</H3
 344 ><P
 345 > Did you configure your browser to use <SPAN
 346 CLASS="APPLICATION"
 347 >Privoxy</SPAN
 348 >
 349  as a proxy? It does not sound like it. See above. You might also try flushing
 350  the browser's caches to force a full re-reading of pages. You can verify
 351  that <SPAN
 352 CLASS="APPLICATION"
 353 >Privoxy</SPAN
 354 > is running, and your browser
 355  is correctly configured by entering the special URL:
 356  <A
 357 HREF="http://config.privoxy.org/"
 358 TARGET="_top"
 359 >http://config.privoxy.org/</A
 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 >.</P
 388 ></DIV
 389 ></DIV
 390 ><DIV
 391 CLASS="NAVFOOTER"
 392 ><HR
 393 ALIGN="LEFT"
 394 WIDTH="100%"><TABLE
 395 SUMMARY="Footer navigation table"
 396 WIDTH="100%"
 397 BORDER="0"
 398 CELLPADDING="0"
 399 CELLSPACING="0"
 400 ><TR
 401 ><TD
 402 WIDTH="33%"
 403 ALIGN="left"
 404 VALIGN="top"
 405 ><A
 406 HREF="general.html"
 407 ACCESSKEY="P"
 408 >Prev</A
 409 ></TD
 410 ><TD
 411 WIDTH="34%"
 412 ALIGN="center"
 413 VALIGN="top"
 414 ><A
 415 HREF="index.html"
 416 ACCESSKEY="H"
 417 >Home</A
 418 ></TD
 419 ><TD
 420 WIDTH="33%"
 421 ALIGN="right"
 422 VALIGN="top"
 423 ><A
 424 HREF="configuration.html"
 425 ACCESSKEY="N"
 426 >Next</A
 427 ></TD
 428 ></TR
 429 ><TR
 430 ><TD
 431 WIDTH="33%"
 432 ALIGN="left"
 433 VALIGN="top"
 434 >General Information</TD
 435 ><TD
 436 WIDTH="34%"
 437 ALIGN="center"
 438 VALIGN="top"
 439 >&nbsp;</TD
 440 ><TD
 441 WIDTH="33%"
 442 ALIGN="right"
 443 VALIGN="top"
 444 >Configuration</TD
 445 ></TR
 446 ></TABLE
 447 ></DIV
 448 ></BODY
 449 ></HTML
 450 >