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.60"><LINK
   8 REL="HOME"
   9 TITLE="Privoxy Frequently Asked Questions"
  10 HREF="index.html"><LINK
  11 REL="PREVIOUS"
  12 TITLE="General Information"
  13 HREF="general.html"><LINK
  14 REL="NEXT"
  15 TITLE="Configuration"
  16 HREF="configuration.html"><LINK
  17 REL="STYLESHEET"
  18 TYPE="text/css"
  19 HREF="../p_doc.css"></HEAD
  20 ><BODY
  21 CLASS="SECT1"
  22 BGCOLOR="#EEEEEE"
  23 TEXT="#000000"
  24 LINK="#0000FF"
  25 VLINK="#840084"
  26 ALINK="#0000FF"
  27 ><DIV
  28 CLASS="NAVHEADER"
  29 ><TABLE
  30 WIDTH="100%"
  31 BORDER="0"
  32 CELLPADDING="0"
  33 CELLSPACING="0"
  34 ><TR
  35 ><TH
  36 COLSPAN="3"
  37 ALIGN="center"
  38 >Privoxy Frequently Asked Questions</TH
  39 ></TR
  40 ><TR
  41 ><TD
  42 WIDTH="10%"
  43 ALIGN="left"
  44 VALIGN="bottom"
  45 ><A
  46 HREF="general.html"
  47 >Prev</A
  48 ></TD
  49 ><TD
  50 WIDTH="80%"
  51 ALIGN="center"
  52 VALIGN="bottom"
  53 ></TD
  54 ><TD
  55 WIDTH="10%"
  56 ALIGN="right"
  57 VALIGN="bottom"
  58 ><A
  59 HREF="configuration.html"
  60 >Next</A
  61 ></TD
  62 ></TR
  63 ></TABLE
  64 ><HR
  65 ALIGN="LEFT"
  66 WIDTH="100%"></DIV
  67 ><DIV
  68 CLASS="SECT1"
  69 ><H1
  70 CLASS="SECT1"
  71 ><A
  72 NAME="INSTALLATION"
  73 >2. Installation</A
  74 ></H1
  75 ><DIV
  76 CLASS="SECT2"
  77 ><H3
  78 CLASS="SECT2"
  79 ><A
  80 NAME="WHICHBROWSERS"
  81 >2.1. Which browsers are supported by <SPAN
  82 CLASS="APPLICATION"
  83 >Privoxy</SPAN
  84 >?</A
  85 ></H3
  86 ><P
  87 > Any browser that can be configured to use a proxy, which
  88  should be virtually all browsers. Direct browser support is not necessary
  89  since <SPAN
  90 CLASS="APPLICATION"
  91 >Privoxy</SPAN
  92 > runs as a separate application and
  93  talks to the browser in the standardized HTTP protocol, just like a web server
  94  does.</P
  95 ></DIV
  96 ><DIV
  97 CLASS="SECT2"
  98 ><H3
  99 CLASS="SECT2"
 100 ><A
 101 NAME="WHICHOS"
 102 >2.2. Which operating systems are supported?</A
 103 ></H3
 104 ><P
 105 > At present, <SPAN
 106 CLASS="APPLICATION"
 107 >Privoxy</SPAN
 108 > is known to run on
 109  Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Conectiva),
 110  Mac OSX, OS/2, AmigaOS, BeOS, FreeBSD, NetBSD, Solaris,  and many more
 111  flavors of Unix.</P
 112 ><P
 113 > But any operating system that runs TCP/IP, can conceivably take advantage of
 114  <SPAN
 115 CLASS="APPLICATION"
 116 >Privoxy</SPAN
 117 > in a networked situation where
 118  <SPAN
 119 CLASS="APPLICATION"
 120 >Privoxy</SPAN
 121 > would run as a server on a LAN gateway.
 122  Then only the <SPAN
 123 CLASS="QUOTE"
 124 >"gateway"</SPAN
 125 > needs to be running one of the above
 126  operating systems.</P
 127 ><P
 128 > Source code is freely available, so porting to other operating systems
 129  is always a possibility.</P
 130 ></DIV
 131 ><DIV
 132 CLASS="SECT2"
 133 ><H3
 134 CLASS="SECT2"
 135 ><A
 136 NAME="NEWINSTALL"
 137 >2.3. Can I install
 138  <SPAN
 139 CLASS="APPLICATION"
 140 >Privoxy</SPAN
 141 > over <SPAN
 142 CLASS="APPLICATION"
 143 >Junkbuster</SPAN
 144 >?</A
 145 ></H3
 146 ><P
 147 >   We recommend you un-install <SPAN
 148 CLASS="APPLICATION"
 149 >Junkbuster</SPAN
 150 >
 151    first to minimize conflicts and confusion. You may want to
 152    save your old configuration files for future reference. The configuration
 153    files and syntax have substantially changed, so you will need to manually
 154    port your old patterns. See the <A
 155 HREF="../user-manual/upgradersnote.html"
 156 TARGET="_top"
 157 >note
 158    to upgraders</A
 159 > and <A
 160 HREF="../user-manual/installation.html"
 161 TARGET="_top"
 162 >installation
 163    chapter</A
 164 > in the <A
 165 HREF="../user-manual/index.html"
 166 TARGET="_top"
 167 >user manual</A
 168 >
 169    for details.
 170  </P
 171 ><P
 172 >  Note: Some installers may automatically un-install
 173   <SPAN
 174 CLASS="APPLICATION"
 175 >Junkbuster</SPAN
 176 >, if present!
 177  </P
 178 ></DIV
 179 ><DIV
 180 CLASS="SECT2"
 181 ><H3
 182 CLASS="SECT2"
 183 ><A
 184 NAME="AEN209"
 185 >2.4. I just installed <SPAN
 186 CLASS="APPLICATION"
 187 >Privoxy</SPAN
 188 >. Is there anything
 189 special I have to do now?</A
 190 ></H3
 191 ><P
 192 > All browsers must be told to use <SPAN
 193 CLASS="APPLICATION"
 194 >Privoxy</SPAN
 195 >
 196  as a proxy by specifying the correct proxy address and port number
 197  in the appropriate configuration area for the browser. See below.
 198  You should also flush your browser's memory and disk cache to get rid of any
 199  cached junk items.&#13;</P
 200 ></DIV
 201 ><DIV
 202 CLASS="SECT2"
 203 ><H3
 204 CLASS="SECT2"
 205 ><A
 206 NAME="LOCALHOST"
 207 >2.5. What is the proxy address of <SPAN
 208 CLASS="APPLICATION"
 209 >Privoxy</SPAN
 210 >?</A
 211 ></H3
 212 ><P
 213 >  If you set up the <SPAN
 214 CLASS="APPLICATION"
 215 >Privoxy</SPAN
 216 > to run on
 217   the computer you browse from (rather than your ISP's server or some
 218   networked computer on a LAN), the proxy will be on <TT
 219 CLASS="LITERAL"
 220 >127.0.0.1</TT
 221 >
 222   (sometimes referred to as <SPAN
 223 CLASS="QUOTE"
 224 >"localhost"</SPAN
 225 >,
 226   which is the special name used by every computer on the Internet to refer
 227   to itself) and the port will be 8118 (unless you have <SPAN
 228 CLASS="APPLICATION"
 229 >Privoxy</SPAN
 230 >
 231   to run on a different port with the <A
 232 HREF="../user-manual/config.html#LISTEN-ADDRESS"
 233 TARGET="_top"
 234 >listen-address</A
 235 > config option).
 236  </P
 237 ><P
 238 >  When configuring your browser's proxy settings you typically enter
 239   the word <SPAN
 240 CLASS="QUOTE"
 241 >"localhost"</SPAN
 242 > or the IP address <SPAN
 243 CLASS="QUOTE"
 244 >"127.0.0.1"</SPAN
 245 >
 246   in the boxes next to <SPAN
 247 CLASS="QUOTE"
 248 >"HTTP"</SPAN
 249 > and <SPAN
 250 CLASS="QUOTE"
 251 >"Secure"</SPAN
 252 > (HTTPS) and
 253   then the number <SPAN
 254 CLASS="QUOTE"
 255 >"8118"</SPAN
 256 > for <SPAN
 257 CLASS="QUOTE"
 258 >"port"</SPAN
 259 >.
 260   This tells your browser to send all web requests to <SPAN
 261 CLASS="APPLICATION"
 262 >Privoxy</SPAN
 263 >
 264   instead of directly to the Internet.
 265  </P
 266 ><P
 267 >  <SPAN
 268 CLASS="APPLICATION"
 269 >Privoxy</SPAN
 270 > can also be used to proxy for
 271   a Local Area Network. In this case, your would enter either the IP
 272   address of the LAN host where <SPAN
 273 CLASS="APPLICATION"
 274 >Privoxy</SPAN
 275 >
 276   is running, or the equivalent hostname. Port assignment would be
 277   same as above. Note that <SPAN
 278 CLASS="APPLICATION"
 279 >Privoxy</SPAN
 280 > doesn't
 281   listen on any LAN interfaces by default.
 282  </P
 283 ><P
 284 >  <SPAN
 285 CLASS="APPLICATION"
 286 >Privoxy</SPAN
 287 > does not currently handle
 288   protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
 289   protocols.
 290  </P
 291 ></DIV
 292 ><DIV
 293 CLASS="SECT2"
 294 ><H3
 295 CLASS="SECT2"
 296 ><A
 297 NAME="AEN237"
 298 >2.6. I just installed <SPAN
 299 CLASS="APPLICATION"
 300 >Privoxy</SPAN
 301 >, and nothing is happening.
 302 All the ads are there. What's wrong?</A
 303 ></H3
 304 ><P
 305 > Did you configure your browser to use <SPAN
 306 CLASS="APPLICATION"
 307 >Privoxy</SPAN
 308 >
 309  as a proxy? It does not sound like it. See above. You might also try flushing
 310  the browser's caches to force a full re-reading of pages. You can verify
 311  that <SPAN
 312 CLASS="APPLICATION"
 313 >Privoxy</SPAN
 314 > is running, and your browser
 315  is correctly configured by entering the special URL:
 316  <A
 317 HREF="http://config.privoxy.org/"
 318 TARGET="_top"
 319 >http://config.privoxy.org/</A
 320 >.
 321  This should take you to a page titled <SPAN
 322 CLASS="QUOTE"
 323 >"This is Privoxy.."</SPAN
 324 > with
 325  access to <SPAN
 326 CLASS="APPLICATION"
 327 >Privoxy's</SPAN
 328 > internal configuration.
 329  If you see this, then you are good to go. If you receive a page saying
 330  <SPAN
 331 CLASS="QUOTE"
 332 >"Privoxy is not running"</SPAN
 333 >, then the browser is not set up to use
 334  your <SPAN
 335 CLASS="APPLICATION"
 336 >Privoxy</SPAN
 337 > installation.
 338  If you receive anything else (probably nothing at all), it could either
 339  be that the browser is not set up correctly, or that
 340  <SPAN
 341 CLASS="APPLICATION"
 342 >Privoxy</SPAN
 343 > is not running at all. Check the <A
 344 HREF="../user-manual/config.html#LOGFILE"
 345 TARGET="_top"
 346 >log file</A
 347 >.
 348 &#13;</P
 349 ></DIV
 350 ></DIV
 351 ><DIV
 352 CLASS="NAVFOOTER"
 353 ><HR
 354 ALIGN="LEFT"
 355 WIDTH="100%"><TABLE
 356 WIDTH="100%"
 357 BORDER="0"
 358 CELLPADDING="0"
 359 CELLSPACING="0"
 360 ><TR
 361 ><TD
 362 WIDTH="33%"
 363 ALIGN="left"
 364 VALIGN="top"
 365 ><A
 366 HREF="general.html"
 367 >Prev</A
 368 ></TD
 369 ><TD
 370 WIDTH="34%"
 371 ALIGN="center"
 372 VALIGN="top"
 373 ><A
 374 HREF="index.html"
 375 >Home</A
 376 ></TD
 377 ><TD
 378 WIDTH="33%"
 379 ALIGN="right"
 380 VALIGN="top"
 381 ><A
 382 HREF="configuration.html"
 383 >Next</A
 384 ></TD
 385 ></TR
 386 ><TR
 387 ><TD
 388 WIDTH="33%"
 389 ALIGN="left"
 390 VALIGN="top"
 391 >General Information</TD
 392 ><TD
 393 WIDTH="34%"
 394 ALIGN="center"
 395 VALIGN="top"
 396 >&nbsp;</TD
 397 ><TD
 398 WIDTH="33%"
 399 ALIGN="right"
 400 VALIGN="top"
 401 >Configuration</TD
 402 ></TR
 403 ></TABLE
 404 ></DIV
 405 ></BODY
 406 ></HTML
 407 >