<title>Starting Privoxy</title>
<meta name="GENERATOR" content=
"Modular DocBook HTML Stylesheet Version 1.79">
- <link rel="HOME" title="Privoxy 3.0.20 User Manual" href="index.html">
+ <link rel="HOME" title="Privoxy 3.0.25 User Manual" href="index.html">
<link rel="PREVIOUS" title="Quickstart to Using Privoxy" href=
"quickstart.html">
<link rel="NEXT" title="Privoxy Configuration" href="configuration.html">
<table summary="Header navigation table" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
- <th colspan="3" align="center">Privoxy 3.0.20 User Manual</th>
+ <th colspan="3" align="center">Privoxy 3.0.25 User Manual</th>
</tr>
<tr>
protocols.</p>
<div class="FIGURE">
- <a name="AEN916" id="AEN916"></a>
+ <a name="AEN629" id="AEN629"></a>
<p><b>Figure 2. Proxy Configuration Showing Mozilla/Netscape HTTP and
HTTPS (SSL) Settings</b></p>
only HTTP and HTTPS (SSL)!</p>
<div class="FIGURE">
- <a name="AEN961" id="AEN961"></a>
+ <a name="AEN674" id="AEN674"></a>
<p><b>Figure 3. Proxy Configuration Showing Internet Explorer HTTP and
HTTPS (Secure) Settings</b></p>
will try <tt class="FILENAME">config.txt</tt>.</p>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-REDHAT" id="START-REDHAT">5.1. Red Hat
- and Fedora</a></h2>
-
- <p>A default Red Hat installation may not start <span class=
- "APPLICATION">Privoxy</span> upon boot. It will use the file <tt class=
- "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- # /etc/rc.d/init.d/privoxy start
-</pre>
- </td>
- </tr>
- </table>
+ <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.1.
+ Debian</a></h2>
- <p>Or ...</p>
+ <p>We use a script. Note that Debian typically starts <span class=
+ "APPLICATION">Privoxy</span> upon booting per default. It will use the
+ file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
+ configuration file.</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
- # service privoxy start
+ # /etc/init.d/privoxy start
</pre>
</td>
</tr>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-DEBIAN" id="START-DEBIAN">5.2.
- Debian</a></h2>
+ <h2 class="SECT2"><a name="START-FREEBSD" id="START-FREEBSD">5.2.
+ FreeBSD and ElectroBSD</a></h2>
- <p>We use a script. Note that Debian typically starts <span class=
- "APPLICATION">Privoxy</span> upon booting per default. It will use the
- file <tt class="FILENAME">/etc/privoxy/config</tt> as its main
- configuration file.</p>
+ <p>To start <span class="APPLICATION">Privoxy</span> upon booting, add
+ "privoxy_enable='YES'" to <tt class="FILENAME">/etc/rc.conf</tt>.
+ <span class="APPLICATION">Privoxy</span> will use <tt class=
+ "FILENAME">/usr/local/etc/privoxy/config</tt> as its main configuration
+ file.</p>
+
+ <p>If you installed <span class="APPLICATION">Privoxy</span> into a
+ jail, the paths above are relative to the jail root.</p>
+
+ <p>To start <span class="APPLICATION">Privoxy</span> manually, run:</p>
<table border="0" bgcolor="#E0E0E0" width="100%">
<tr>
<td>
<pre class="SCREEN">
- # /etc/init.d/privoxy start
+ # service privoxy onestart
</pre>
</td>
</tr>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4.
- Solaris, NetBSD, FreeBSD, HP-UX and others</a></h2>
+ <h2 class="SECT2"><a name="START-UNICES" id="START-UNICES">5.4. Generic
+ instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</a></h2>
<p>Example Unix startup command:</p>
<tr>
<td>
<pre class="SCREEN">
- # /usr/sbin/privoxy /etc/privoxy/config
+ # /usr/sbin/privoxy --user privoxy /etc/privoxy/config
</pre>
</td>
</tr>
</table>
+
+ <p>Note that if you installed <span class="APPLICATION">Privoxy</span>
+ through a package manager, the package will probably contain a
+ platform-specific script or configuration file to start <span class=
+ "APPLICATION">Privoxy</span> upon boot.</p>
</div>
<div class="SECT2">
<h2 class="SECT2"><a name="START-MACOSX" id="START-MACOSX">5.6. Mac OS
X</a></h2>
- <p>After downloading the privoxy software, unzip the downloaded file by
- double-clicking on the zip file icon. Then, double-click on the
- installer package icon and follow the installation process.</p>
-
<p>The privoxy service will automatically start after a successful
- installation. In addition, the privoxy service will automatically start
- every time your computer starts up.</p>
+ installation (and thereafter every time your computer starts up)
+ however you will need to configure your web browser(s) to use it. To do
+ so, configure them to use a proxy for HTTP and HTTPS at the address
+ 127.0.0.1:8118.</p>
<p>To prevent the privoxy service from automatically starting when your
- computer starts up, remove or rename the folder named
- /Library/StartupItems/Privoxy.</p>
-
- <p>A simple application named Privoxy Utility has been created which
- enables administrators to easily start and stop the privoxy
- service.</p>
-
- <p>In addition, the Privoxy Utility presents a simple way for
- administrators to edit the various privoxy config files. A method to
- uninstall the software is also available.</p>
-
- <p>An administrator username and password must be supplied in order for
- the Privoxy Utility to perform any of the tasks.</p>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="START-AMIGAOS" id="START-AMIGAOS">5.7.
- AmigaOS</a></h2>
-
- <p>Start <span class="APPLICATION">Privoxy</span> (with RUN
- <>NIL:) in your <tt class="FILENAME">startnet</tt> script
- (AmiTCP), in <tt class="FILENAME">s:user-startup</tt> (RoadShow), as
- startup program in your startup script (Genesis), or as startup action
- (Miami and MiamiDx). <span class="APPLICATION">Privoxy</span> will
- automatically quit when you quit your TCP/IP stack (just ignore the
- harmless warning your TCP/IP stack may display that <span class=
- "APPLICATION">Privoxy</span> is still running).</p>
+ computer starts up, remove or rename the file <tt class=
+ "LITERAL">/Library/LaunchDaemons/org.ijbswa.privoxy.plist</tt> (on OS X
+ 10.5 and higher) or the folder named <tt class=
+ "LITERAL">/Library/StartupItems/Privoxy</tt> (on OS X 10.4
+ 'Tiger').</p>
+
+ <p>To manually start or stop the privoxy service, use the scripts
+ startPrivoxy.sh and stopPrivoxy.sh supplied in /Applications/Privoxy.
+ They must be run from an administrator account, using sudo.</p>
</div>
<div class="SECT2">
- <h2 class="SECT2"><a name="START-GENTOO" id="START-GENTOO">5.8.
- Gentoo</a></h2>
-
- <p>A script is again used. It will use the file <tt class=
- "FILENAME">/etc/privoxy/config</tt> as its main configuration file.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- /etc/init.d/privoxy start
-
-</pre>
- </td>
- </tr>
- </table>
-
- <p>Note that <span class="APPLICATION">Privoxy</span> is not
- automatically started at boot time by default. You can change this with
- the <tt class="LITERAL">rc-update</tt> command.</p>
-
- <table border="0" bgcolor="#E0E0E0" width="100%">
- <tr>
- <td>
- <pre class="SCREEN">
- rc-update add privoxy default
-
-</pre>
- </td>
- </tr>
- </table>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.9. Command
+ <h2 class="SECT2"><a name="CMDOPTIONS" id="CMDOPTIONS">5.7. Command
Line Options</a></h2>
<p><span class="APPLICATION">Privoxy</span> may be invoked with the
following command-line options:</p>
<ul>
+ <li>
+ <p><span class="emphasis"><i class=
+ "EMPHASIS">--config-test</i></span></p>
+
+ <p>Exit after loading the configuration files before binding to the
+ listen address. The exit code signals whether or not the
+ configuration files have been successfully loaded.</p>
+
+ <p>If the exit code is 1, at least one of the configuration files
+ is invalid, if it is 0, all the configuration files have been
+ successfully loaded (but may still contain errors that can
+ currently only be detected at run time).</p>
+
+ <p>This option doesn't affect the log setting, combination with
+ <span class="emphasis"><i class="EMPHASIS">--no-daemon</i></span>
+ is recommended if a configured log file shouldn't be used.</p>
+ </li>
+
<li>
<p><span class="emphasis"><i class=
"EMPHASIS">--version</i></span></p>
<p><span class="emphasis"><i class="EMPHASIS">--pre-chroot-nslookup
hostname</i></span></p>
- <p>Specifies a hostname to look up before doing a chroot. On some
- systems, initializing the resolver library involves reading config
- files from /etc and/or loading additional shared libraries from
- /lib. On these systems, doing a hostname lookup before the chroot
- reduces the number of files that must be copied into the chroot
- tree.</p>
+ <p>Specifies a hostname (for example www.privoxy.org) to look up
+ before doing a chroot. On some systems, initializing the resolver
+ library involves reading config files from /etc and/or loading
+ additional shared libraries from /lib. On these systems, doing a
+ hostname lookup before the chroot reduces the number of files that
+ must be copied into the chroot tree.</p>
<p>For fastest startup speed, a good value is a hostname that is
not in /etc/hosts but that your local name server (listed in