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