Fix broken links. Add faq on hosts files. Move most of new windows service
[privoxy.git] / doc / webserver / faq / installation.html
index c311e10..f1ce470 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
@@ -71,30 +74,39 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="INSTALLATION"
->2. Installation</A
-></H1
+></A
+>2. Installation</H1
 ><DIV
 CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
 NAME="WHICHBROWSERS"
+></A
 >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 
- should be virtually all browsers. Direct browser support is not necessary
- since <SPAN
+> Any browser that can be configured to use a proxy, which 
+ should be virtually all browsers, including
+ <SPAN
+CLASS="APPLICATION"
+>Firefox</SPAN
+>, <SPAN
+CLASS="APPLICATION"
+>Internet
+ Explorer</SPAN
+>, and <SPAN
+CLASS="APPLICATION"
+>Opera</SPAN
+> among others.
+ Direct browser support is not an absolute requirement 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
+> runs as a separate application and talks
to the browser in the standardized HTTP protocol, just like a web server
  does.</P
 ></DIV
 ><DIV
@@ -103,15 +115,16 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="WHICHOS"
->2.2. Which operating systems are supported?</A
-></H3
+></A
+>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, Fedora, Gentoo, 
+ Slackware and others), Mac OSX, OS/2, AmigaOS, FreeBSD, NetBSD, OpenBSD,
+ Solaris, and various other flavors of Unix.</P
 ><P
 > But any operating system that runs TCP/IP, can conceivably take advantage of
  <SPAN
@@ -126,9 +139,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 +149,79 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
+NAME="EMAIL-CLIENT"
+></A
+>2.3. Can I use <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> with my email client?</H3
+><P
+> As long as there is some way to set a HTTP proxy for the client, then yes,
+ any application can be used, whether it is strictly speaking a
+ <SPAN
+CLASS="QUOTE"
+>"browser"</SPAN
+> or not. Though this may not be the best approach for
+ dealing with some of the common abuses of HTML in email. See <A
+HREF="configuration.html#OUTLOOK"
+>How can I configure <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>
+ with <SPAN
+CLASS="APPLICATION"
+>Outlook Express</SPAN
+>?</A
+> below for more on
+ this. </P
+><P
+> Be aware that HTML email presents a number of unique security and privacy
+ related issues, that can require advanced skills to overcome. The developers
+ recommend using email clients that can be configured to convert HTML to plain
+ text for these reasons.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
 NAME="NEWINSTALL"
->2.3. Can I install  
+></A
+>2.4. 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 +233,13 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN189"
->2.4. I just installed <SPAN
+NAME="AEN235"
+></A
+>2.5. 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,8 +247,8 @@ 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, and remove any stored cookies.&#13;</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -199,29 +256,34 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="LOCALHOST"
->2.5. What is the proxy address of <SPAN
+></A
+>2.6. 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 +291,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,15 +326,19 @@ 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
 CLASS="APPLICATION"
 >Privoxy</SPAN
 > does not currently handle
-  protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
-  protocols. 
+  any other protocols such as FTP, SMTP, IM, IRC, ICQ, etc. Be sure that
+  proxying any of these other protocols is not activated.
  </P
 ></DIV
 ><DIV
@@ -277,13 +346,13 @@ CLASS="SECT2"
 ><H3
 CLASS="SECT2"
 ><A
-NAME="AEN214"
->2.6. I just installed <SPAN
+NAME="NOTHING"
+></A
+>2.7. 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"
@@ -300,20 +369,176 @@ CLASS="APPLICATION"
 HREF="http://p.p/"
 TARGET="_top"
 >http://p.p/</A
->. This should give you 
- a banner that says <SPAN
+>. 
+ 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
+> 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
+>. For instructions
+ on starting <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> and browser configuration,
+ see the <A
+HREF="http://www.privoxy.org/user-manual/startup.html"
+TARGET="_top"
+>chapter
+ on starting <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+></A
+> in the
+ <A
+HREF="http://www.privoxy.org/user-manual/"
+TARGET="_top"
+>user manual</A
+>.</P
+></DIV
+><DIV
+CLASS="SECT2"
+><H3
+CLASS="SECT2"
+><A
+NAME="NOTUSED"
+></A
+>2.8. I get a <SPAN
+CLASS="QUOTE"
+>"Privoxy is not being used"</SPAN
+> dummy page although
+<SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> is running and being used.</H3
+><P
+> First, make sure that Privoxy is <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>really</I
+></SPAN
+> running and
+ being used by visiting <A
+HREF="http://p.p/"
+TARGET="_top"
+>http://p.p/</A
+>. You
+ should see the <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+> main page. If not, see
+ the <A
+HREF="http://www.privoxy.org/user-manual/startup.html"
+TARGET="_top"
+>chapter
+ on starting <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+></A
+> in the
+ <A
+HREF="http://www.privoxy.org/user-manual/"
+TARGET="_top"
+>user manual</A
+>.</P
+><P
+> Now if <A
+HREF="http://p.p/"
+TARGET="_top"
+>http://p.p/</A
+> works for you, but
+ other parts of <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+>'s web interface show
+ the dummy page, your browser has cached a redirection it encountered before
  <SPAN
 CLASS="APPLICATION"
 >Privoxy</SPAN
-> are not set up correctly.&#13;</P
+> was being used. You need to clear your
+ browser's cache. Note that shift-reloading the dummy page won't help, since
+ that'll only refresh the dummy page, not the redirection that lead you there.</P
+><P
+> The procedure for clearing the cache varies from browser to browser. For
+ example, <SPAN
+CLASS="APPLICATION"
+>Mozilla/Netscape</SPAN
+> users would click 
+ <SPAN
+CLASS="GUIBUTTON"
+>Edit</SPAN
+> --&#62; <SPAN
+CLASS="GUIBUTTON"
+>Preferences</SPAN
+> --&#62;
+ <SPAN
+CLASS="GUIBUTTON"
+>Advanced</SPAN
+> --&#62; <SPAN
+CLASS="GUIBUTTON"
+>Cache</SPAN
+> and
+ then click both <SPAN
+CLASS="QUOTE"
+>"<SPAN
+CLASS="GUIBUTTON"
+>Clear Memory Cache</SPAN
+>"</SPAN
+>
+ and <SPAN
+CLASS="QUOTE"
+>"<SPAN
+CLASS="GUIBUTTON"
+>Clear Disk Cache</SPAN
+>"</SPAN
+>.
+ And, <SPAN
+CLASS="APPLICATION"
+>Firefox</SPAN
+> users would click 
+ <SPAN
+CLASS="GUIBUTTON"
+>Tools</SPAN
+> --&#62; <SPAN
+CLASS="GUIBUTTON"
+>Options</SPAN
+> --&#62;
+ <SPAN
+CLASS="GUIBUTTON"
+>Privacy</SPAN
+> --&#62; <SPAN
+CLASS="GUIBUTTON"
+>Cache</SPAN
+> and
+ then click <SPAN
+CLASS="QUOTE"
+>"<SPAN
+CLASS="GUIBUTTON"
+>Clear Cache Now</SPAN
+>"</SPAN
+>.&#13;</P
 ></DIV
 ></DIV
 ><DIV
@@ -321,6 +546,7 @@ CLASS="NAVFOOTER"
 ><HR
 ALIGN="LEFT"
 WIDTH="100%"><TABLE
+SUMMARY="Footer navigation table"
 WIDTH="100%"
 BORDER="0"
 CELLPADDING="0"
@@ -332,6 +558,7 @@ ALIGN="left"
 VALIGN="top"
 ><A
 HREF="general.html"
+ACCESSKEY="P"
 >Prev</A
 ></TD
 ><TD
@@ -340,6 +567,7 @@ ALIGN="center"
 VALIGN="top"
 ><A
 HREF="index.html"
+ACCESSKEY="H"
 >Home</A
 ></TD
 ><TD
@@ -348,6 +576,7 @@ ALIGN="right"
 VALIGN="top"
 ><A
 HREF="configuration.html"
+ACCESSKEY="N"
 >Next</A
 ></TD
 ></TR