TITLE="Privoxy User Manual"
HREF="index.html"><LINK
REL="PREVIOUS"
-TITLE="Installation"
-HREF="installation.html"><LINK
+TITLE="Note to Upgraders"
+HREF="upgradersnote.html"><LINK
REL="NEXT"
-TITLE="Privoxy Configuration"
-HREF="configuration.html"><LINK
+TITLE="Starting Privoxy"
+HREF="startup.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="../p_doc.css"></HEAD
ALIGN="left"
VALIGN="bottom"
><A
-HREF="installation.html"
+HREF="upgradersnote.html"
>Prev</A
></TD
><TD
ALIGN="right"
VALIGN="bottom"
><A
-HREF="configuration.html"
+HREF="startup.html"
>Next</A
></TD
></TR
CLASS="SECT1"
><A
NAME="QUICKSTART"
->4. Quickstart to Using <SPAN
+>5. Quickstart to Using <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
></A
></H1
><P
-> Before launching <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> for the first time, you
- will want to configure your browser(s) to use <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->
- as a HTTP and HTTPS proxy. The default is localhost for the proxy address,
- and port 8118 (earlier versions used port 800). This is the one required
- configuration that must be done! </P
-><P
->
- With <SPAN
-CLASS="APPLICATION"
->Netscape</SPAN
-> (and
- <SPAN
-CLASS="APPLICATION"
->Mozilla</SPAN
->), this can be set under <TT
-CLASS="LITERAL"
->Edit
- -> Preferences -> Advanced -> Proxies -> HTTP Proxy</TT
->.
- For <SPAN
-CLASS="APPLICATION"
->Internet Explorer</SPAN
->: <TT
-CLASS="LITERAL"
->Tools ->
- Internet Properties -> Connections -> LAN Setting</TT
->. Then,
- check <SPAN
-CLASS="QUOTE"
->"Use Proxy"</SPAN
-> and fill in the appropriate info (Address:
- localhost, Port: 8118). Include if HTTPS proxy support too.</P
-><P
-> After doing this, flush your browser's disk and memory caches to force a
- re-reading of all pages and get rid of any ads that may be cached. You
- are now ready to start enjoying the benefits of using
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->.</P
-><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is typically started by specifying the
- main configuration file to be used on the command line. Example Unix startup
- command:</P
-><P
-> <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
->
- # /usr/sbin/privoxy /etc/privoxy/config
-
- </PRE
-></TD
-></TR
-></TABLE
-></P
-><P
-> An init script is provided for SuSE and Redhat.</P
-><P
-> For for SuSE: <B
-CLASS="COMMAND"
->/etc/rc.d/privoxy start</B
-></P
-><P
-> For RedHat: <B
-CLASS="COMMAND"
->/etc/rc.d/init.d/privoxy start</B
+> <P
></P
+><UL
+><LI
><P
-> If no configuration file is specified on the command line,
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> will look for a file named
- <TT
-CLASS="FILENAME"
->config</TT
-> in the current directory. Except on Win32 where
- it will try <TT
-CLASS="FILENAME"
->config.txt</TT
->. If no file is specified on the
- command line and no default configuration file can be found,
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> will fail to start.</P
-><P
-> The included default configuration files should give a reasonable starting
- point, though may be somewhat aggressive in blocking junk. Most of the
- per site configuration is done in the <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> files. These
- are where various cookie actions are defined, ad and banner blocking,
- and other aspects of <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> configuration. There
- are several such files included, with varying levels of aggressiveness. </P
-><P
-> You will probably want to keep an eye out for sites that require persistent
- cookies, and add these to <TT
-CLASS="FILENAME"
->default.action</TT
-> as needed. By
- default, most of these will be accepted only during the current browser
- session, until you add them to the configuration. If you want the browser to
- handle this instead, you will need to edit
- <TT
-CLASS="FILENAME"
->default.action</TT
-> and disable this feature. If you use more
- than one browser, it would make more sense to let
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> handle this. In which case, the browser(s)
- should be set to accept all cookies.</P
-><P
-> <SPAN
+> Install <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is HTTP/1.1 compliant, but not all 1.1
- features are as yet implemented. If browsers that support HTTP/1.1 (like
- <SPAN
-CLASS="APPLICATION"
->Mozilla</SPAN
-> or recent versions of I.E.) experience
- problems, you might try to force HTTP/1.0 compatibility. For Mozilla, look
- under <TT
-CLASS="LITERAL"
->Edit -> Preferences -> Debug -> Networking</TT
+>. See the section <A
+HREF="installation.html"
+>Installing</A
>.
- Or set the <SPAN
-CLASS="QUOTE"
->"+downgrade"</SPAN
-> config option in
- <TT
-CLASS="FILENAME"
->default.action</TT
->.</P
-><P
-> After running <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> for a while, you can
- start to fine tune the configuration to suit your personal, or site,
- preferences and requirements. There are many, many aspects that can
- be customized. <SPAN
-CLASS="QUOTE"
->"Actions"</SPAN
-> (as specified in <TT
-CLASS="FILENAME"
->default.action</TT
->)
- can be adjusted by pointing your browser to
- <A
-HREF="http://p.p/"
-TARGET="_top"
->http://p.p/</A
->,
- and then follow the link to <SPAN
-CLASS="QUOTE"
->"edit the actions list"</SPAN
->.
- (This is an internal page and does not require Internet access.)</P
-><P
-> In fact, various aspects of <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
->
- configuration can be viewed from this page, including
- current configuration parameters, source code version numbers,
- the browser's request headers, and <SPAN
-CLASS="QUOTE"
->"actions"</SPAN
-> that apply
- to a given URL. In addition to the <TT
-CLASS="FILENAME"
->default.action</TT
-> file
- editor mentioned above, <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> can also
- be turned <SPAN
-CLASS="QUOTE"
->"on"</SPAN
-> and <SPAN
-CLASS="QUOTE"
->"off"</SPAN
-> from this page.</P
+ </P
+></LI
+><LI
><P
-> If you encounter problems, please verify it is a
- <SPAN
+> Start <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> bug, by disabling
- <SPAN
+>. See the section <A
+HREF="startup.html"
+>Starting <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
->, and then trying the same page.
- Also, try another browser if possible to eliminate browser or site
- problems. Before reporting it as a bug, see if there is not a configuration
- option that is enabled that is causing the page not to load. You can then add
- an exception for that page or site. For instance, try adding it to the
- <TT
-CLASS="LITERAL"
->{fragile}</TT
-> section of <TT
-CLASS="FILENAME"
->default.action</TT
+></A
>.
- This will turn off most actions for this site. For more on troubleshooting
- problem sites, see the <A
-HREF="appendix.html#ACTIONSANAT"
-TARGET="_top"
->Appendix</A
->. If a bug, please report it
- to the developers (see below). </P
-><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
-><A
-NAME="AEN230"
->4.1. Command Line Options</A
-></H2
-><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> may be invoked with the following
- command-line options:</P
-><P
-> <P
-></P
-><UL
-><LI
-><P
-> <I
-CLASS="EMPHASIS"
->--version</I
->
- </P
-><P
-> Print version info and exit, Unix only.
- </P
-></LI
-><LI
-><P
-> <I
-CLASS="EMPHASIS"
->--help</I
->
- </P
-><P
-> Print a short usage info and exit, Unix only.
- </P
-></LI
-><LI
-><P
-> <I
-CLASS="EMPHASIS"
->--no-daemon</I
->
- </P
-><P
-> Don't become a daemon, i.e. don't fork and become process group
- leader, don't detach from controlling tty. Unix only.
</P
></LI
><LI
><P
-> <I
-CLASS="EMPHASIS"
->--pidfile FILE</I
->
-
- </P
-><P
-> On startup, write the process ID to <I
-CLASS="EMPHASIS"
->FILE</I
->. Delete the
- <I
-CLASS="EMPHASIS"
->FILE</I
-> on exit. Failiure to create or delete the
- <I
-CLASS="EMPHASIS"
->FILE</I
-> is non-fatal. If no <I
-CLASS="EMPHASIS"
->FILE</I
->
- option is given, no PID file will be used. Unix only.
- </P
-></LI
-><LI
-><P
-> <I
-CLASS="EMPHASIS"
->--user USER[.GROUP]</I
->
-
- </P
-><P
-> After (optionally) writing the PID file, assume the user ID of
- <I
-CLASS="EMPHASIS"
->USER</I
->, and if included the GID of GROUP. Exit if the
- privileges are not sufficient to do so. Unix only.
+> Change your browser's configuration to use the proxy <TT
+CLASS="LITERAL"
+>localhost</TT
+> on port
+ <TT
+CLASS="LITERAL"
+>8118</TT
+>. See the section <A
+HREF="startup.html"
+>Starting <SPAN
+CLASS="APPLICATION"
+>Privoxy</SPAN
+></A
+>.
</P
></LI
><LI
><P
-> <I
-CLASS="EMPHASIS"
->configfile</I
->
- </P
-><P
-> If no <I
-CLASS="EMPHASIS"
->configfile</I
-> is included on the command line,
- <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> will look for a file named
- <SPAN
-CLASS="QUOTE"
->"config"</SPAN
-> in the current directory (except on Win32
- where it will look for <SPAN
-CLASS="QUOTE"
->"config.txt"</SPAN
-> instead). Specify
- full path to avoid confusion.
+> Enjoy surfing with enhanced comfort and privacy. Please see the section
+ <A
+HREF="contact.html"
+>Contacting the Developers</A
+> on how to report
+ bugs or problems with websites or to get help. You may want to change the
+ file <TT
+CLASS="FILENAME"
+>user.action</TT
+> to further tweak your new browsing
+ experience.
</P
></LI
></UL
></P
></DIV
-></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="left"
VALIGN="top"
><A
-HREF="installation.html"
+HREF="upgradersnote.html"
>Prev</A
></TD
><TD
ALIGN="right"
VALIGN="top"
><A
-HREF="configuration.html"
+HREF="startup.html"
>Next</A
></TD
></TR
WIDTH="33%"
ALIGN="left"
VALIGN="top"
->Installation</TD
+>Note to Upgraders</TD
><TD
WIDTH="34%"
ALIGN="center"
WIDTH="33%"
ALIGN="right"
VALIGN="top"
-><SPAN
+>Starting <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> Configuration</TD
+></TD
></TR
></TABLE
></DIV
projects / privoxy.git / blobdiff