Just regenerating to get fresh version in place of very dated versions.
[privoxy.git] / doc / webserver / faq / installation.html
index 87fa8c7..06fff2b 100644 (file)
@@ -4,7 +4,7 @@
 >Installation</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.64
+CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 "><LINK
 REL="HOME"
 TITLE="Privoxy Frequently Asked Questions"
@@ -28,6 +28,7 @@ ALINK="#0000FF"
 ><DIV
 CLASS="NAVHEADER"
 ><TABLE
+SUMMARY="Header navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -45,6 +46,7 @@ ALIGN="left"
 VALIGN="bottom"
 ><A
 HREF="general.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -58,6 +60,7 @@ ALIGN="right"
 VALIGN="bottom"
 ><A
 HREF="configuration.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR
@@ -70,31 +73,24 @@ CLASS="SECT1"
 ><H1
 CLASS="SECT1"
 ><A
-NAME="INSTALLATION"
->2. Installation</A
-></H1
+NAME="INSTALLATION">2. Installation</H1
 ><DIV
 CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="WHICHBROWSERS"
->2.1. Which browsers are supported by <SPAN
+NAME="WHICHBROWSERS">2.1. Which browsers are supported by <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->?</A
-></H3
+>?</H3
 ><P
-> Any browser that can be configured to use a <SPAN
-CLASS="QUOTE"
->"proxy"</SPAN
->, which 
+> Any browser that can be configured to use a proxy, which 
  should be virtually all browsers. Direct browser support is not necessary
  since <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > runs as a separate application and
just exchanges standard HTML data with your browser, just like a web server
talks to the browser in the standardized HTTP protocol, just like a web server
  does.</P
 ></DIV
 ><DIV
@@ -102,16 +98,15 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="WHICHOS"
->2.2. Which operating systems are supported?</A
-></H3
+NAME="WHICHOS">2.2. Which operating systems are supported?</H3
 ><P
 > At present, <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > is known to run on
- Windows(95, 98, ME, 2000, XP), Linux (RedHat, Suse, Debian), Mac OSX,
- OS/2, AmigaOS, FreeBSD, NetBSD, BeOS, and many more flavors of Unix.</P
+ Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Conectiva, Gentoo,
+ Slackware), Mac OSX, OS/2, AmigaOS, BeOS, FreeBSD, NetBSD, Solaris, and more 
+ flavors of Unix.</P
 ><P
 > But any operating system that runs TCP/IP, can conceivably take advantage of
  <SPAN
@@ -126,9 +121,9 @@ CLASS="APPLICATION"
 CLASS="QUOTE"
 >"gateway"</SPAN
 > needs to be running one of the above
- operating systems. </P
+ operating systems.</P
 ><P
-> Source code is freely available, so porting to other operating systems, 
+> Source code is freely available, so porting to other operating systems 
  is always a possibility.</P
 ></DIV
 ><DIV
@@ -136,35 +131,41 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="NEWINSTALL"
->2.3. Can I install  
+NAME="NEWINSTALL">2.3. Can I install  
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > over <SPAN
 CLASS="APPLICATION"
 >Junkbuster</SPAN
->?</A
-></H3
+>?</H3
 ><P
->   We recommend you uninstall <SPAN
+>   We recommend you un-install <SPAN
 CLASS="APPLICATION"
 >Junkbuster</SPAN
 >
    first to minimize conflicts and confusion. You may want to 
    save your old configuration files for future reference. The configuration
-   is substantially changed.
- </P
-><P
->  See the <A
+   files and syntax have substantially changed, so you will need to manually
+   port your old patterns. See the <A
+HREF="../user-manual/upgradersnote.html"
+TARGET="_top"
+>note
+   to upgraders</A
+> and <A
+HREF="../user-manual/installation.html"
+TARGET="_top"
+>installation
+   chapter</A
+> in the <A
 HREF="../user-manual/index.html"
 TARGET="_top"
->user-manual</A
-> for
-  platform specific installation instructions.
+>user manual</A
+>
+   for details.
  </P
 ><P
->  Note: Some installers may automatically uninstall
+>  Note: Some installers may automatically un-install
   <SPAN
 CLASS="APPLICATION"
 >Junkbuster</SPAN
@@ -176,13 +177,11 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN191"
->2.4. I just installed <SPAN
+NAME="AEN209">2.4. I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >. Is there anything 
-special I have to do now?</A
-></H3
+special I have to do now?</H3
 ><P
 > All browsers must be told to use <SPAN
 CLASS="APPLICATION"
@@ -190,38 +189,41 @@ CLASS="APPLICATION"
 > 
  as a proxy by specifying the correct proxy address and port number 
  in the appropriate configuration area for the browser. See below.
Also, you should flush your browser's memory and disk cache to get rid of any
- cached items.&#13;</P
You should also flush your browser's memory and disk cache to get rid of any
+ cached junk items.&#13;</P
 ></DIV
 ><DIV
 CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="LOCALHOST"
->2.5. What is the proxy address of <SPAN
+NAME="LOCALHOST">2.5. What is the proxy address of <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
->?</A
-></H3
+>?</H3
 ><P
 >  If you set up the <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > to run on
   the computer you browse from (rather than your ISP's server or some
-  networked computer on a LAN), the proxy will be on <SPAN
+  networked computer on a LAN), the proxy will be on <TT
+CLASS="LITERAL"
+>127.0.0.1</TT
+> 
+  (sometimes referred to as <SPAN
 CLASS="QUOTE"
 >"localhost"</SPAN
->
-  (which is the special name used by every computer on the Internet to refer
+>,
+  which is the special name used by every computer on the Internet to refer
   to itself) and the port will be 8118 (unless you have <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> to run on a different port with the
-  <I
-CLASS="EMPHASIS"
->listen-address</I
+>
+  to run on a different port with the <A
+HREF="../user-manual/config.html#LISTEN-ADDRESS"
+TARGET="_top"
+>listen-address</A
 > config option). 
  </P
 ><P
@@ -229,26 +231,29 @@ CLASS="EMPHASIS"
   the word <SPAN
 CLASS="QUOTE"
 >"localhost"</SPAN
-> in the boxes next to <SPAN
+> or the IP address <SPAN
 CLASS="QUOTE"
->"HTTP"</SPAN
+>"127.0.0.1"</SPAN
 >
-  and <SPAN
+  in the boxes next to <SPAN
+CLASS="QUOTE"
+>"HTTP"</SPAN
+> and <SPAN
 CLASS="QUOTE"
 >"Secure"</SPAN
-> (HTTPS) and then the number <SPAN
+> (HTTPS) and
+  then the number <SPAN
 CLASS="QUOTE"
 >"8118"</SPAN
->
-  for <SPAN
+> for <SPAN
 CLASS="QUOTE"
 >"port"</SPAN
->.  This tells your browser to send all web 
-  requests to <SPAN
+>. 
+  This tells your browser to send all web requests to <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> instead of directly to the 
-  Internet.
+>
+  instead of directly to the Internet.
  </P
 ><P
 >  <SPAN
@@ -261,7 +266,11 @@ CLASS="APPLICATION"
 >Privoxy</SPAN
 > 
   is running, or the equivalent hostname. Port assignment would be 
-  same as above.
+  same as above. Note that <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> doesn't
+  listen on any LAN interfaces by default.
  </P
 ><P
 >  <SPAN
@@ -277,13 +286,11 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN216"
->2.6. I just installed <SPAN
+NAME="NOTHING">2.6. I just installed <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
 >, and nothing is happening.
-All the ads are there. What's wrong?</A
-></H3
+All the ads are there. What's wrong?</H3
 ><P
 > Did you configure your browser to use <SPAN
 CLASS="APPLICATION"
@@ -297,23 +304,37 @@ CLASS="APPLICATION"
 > is running, and your browser 
  is correctly configured by entering the special URL: 
  <A
-HREF="http://p.p/"
+HREF="http://config.privoxy.org/"
 TARGET="_top"
->http://p.p/</A
->. This should give you 
a banner that says <SPAN
+>http://config.privoxy.org/</A
+>.
This should take you to a page titled <SPAN
 CLASS="QUOTE"
->"This is Privoxy"</SPAN
-> and 
+>"This is Privoxy.."</SPAN
+> with
  access to <SPAN
 CLASS="APPLICATION"
 >Privoxy's</SPAN
-> internal configuration. 
- If you see this, then you are good to go. If not, the browser or 
+> internal configuration.
+ If you see this, then you are good to go. If you receive a page saying 
  <SPAN
+CLASS="QUOTE"
+>"Privoxy is not running"</SPAN
+>, then the browser is not set up to use
+ your <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> are not set up correctly.&#13;</P
+> installation.
+ If you receive anything else (probably nothing at all), it could either
+ be that the browser is not set up correctly, or that
+ <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is not running at all. Check the <A
+HREF="../user-manual/config.html#LOGFILE"
+TARGET="_top"
+>log file</A
+>.</P
 ></DIV
 ></DIV
 ><DIV
@@ -321,6 +342,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -332,6 +354,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="general.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -340,6 +363,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -348,6 +372,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="configuration.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR