- </td>
- </tr>
- </table>
- </div>
-
- <div class="SECT2">
- <h2 class="SECT2"><a name="START-OS2" id="START-OS2">5.5. OS/2</a></h2>
-
- <p>During installation, <span class="APPLICATION">Privoxy</span> is
- configured to start automatically when the system restarts. You can
- start it manually by double-clicking on the <span class=
- "APPLICATION">Privoxy</span> icon in the <span class=
- "APPLICATION">Privoxy</span> folder.</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>
-
- <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>
+ </td>
+ </tr>
+ </table>
+ </div>
+ <div class="SECT2">
+ <h2 class="SECT2">
+ <a name="START-WINDOWS">5.3. Windows</a>
+ </h2>
+ <p>
+ Click on the <span class="APPLICATION">Privoxy</span> Icon to start
+ <span class="APPLICATION">Privoxy</span>. 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.txt</tt>. Note that Windows will automatically
+ start <span class="APPLICATION">Privoxy</span> when the system
+ starts if you chose that option when installing.
+ </p>
+ <p>
+ <span class="APPLICATION">Privoxy</span> can run with full Windows
+ service functionality. On Windows only, the <span class=
+ "APPLICATION">Privoxy</span> program has two new command line
+ arguments to install and uninstall <span class=
+ "APPLICATION">Privoxy</span> as a service. See the <a href=
+ "installation.html#INSTALLATION-PACK-WIN">Windows Installation
+ instructions</a> for details.
+ </p>
+ </div>
+ <div class="SECT2">
+ <h2 class="SECT2">
+ <a name="START-UNICES">5.4. Generic instructions for Unix derivates
+ (Solaris, NetBSD, HP-UX etc.)</a>
+ </h2>
+ <p>
+ Example Unix startup command:
+ </p>
+ <p>
+ </p>
+ <table border="0" bgcolor="#E0E0E0" width="100%">
+ <tr>
+ <td>
+<pre class="SCREEN">
+ # /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-OS2">5.5. OS/2</a>
+ </h2>
+ <p>
+ During installation, <span class="APPLICATION">Privoxy</span> is
+ configured to start automatically when the system restarts. You can
+ start it manually by double-clicking on the <span class=
+ "APPLICATION">Privoxy</span> icon in the <span class=
+ "APPLICATION">Privoxy</span> folder.
+ </p>
+ </div>
+ <div class="SECT2">
+ <h2 class="SECT2">
+ <a name="START-MACOSX">5.6. Mac OS X</a>
+ </h2>
+ <p>
+ The privoxy service will automatically start after a successful
+ 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 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="CMDOPTIONS">5.7. Command Line Options</a>
+ </h2>
+ <p>
+ <span class="APPLICATION">Privoxy</span> may be invoked with the
+ following command-line options:
+ </p>
+ <p>
+ </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>
+ Print version info and exit. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class="EMPHASIS">--help</i></span>
+ </p>
+ <p>
+ Print short usage info and exit. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class=
+ "EMPHASIS">--no-daemon</i></span>
+ </p>
+ <p>
+ Don't become a daemon, i.e. don't fork and become process group
+ leader, and don't detach from controlling tty. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class="EMPHASIS">--pidfile
+ FILE</i></span>
+ </p>
+ <p>
+ On startup, write the process ID to <span class="emphasis"><i
+ class="EMPHASIS">FILE</i></span>. Delete the <span class=
+ "emphasis"><i class="EMPHASIS">FILE</i></span> on exit. Failure
+ to create or delete the <span class="emphasis"><i class=
+ "EMPHASIS">FILE</i></span> is non-fatal. If no <span class=
+ "emphasis"><i class="EMPHASIS">FILE</i></span> option is given,
+ no PID file will be used. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class="EMPHASIS">--user
+ USER[.GROUP]</i></span>
+ </p>
+ <p>
+ After (optionally) writing the PID file, assume the user ID of
+ <span class="emphasis"><i class="EMPHASIS">USER</i></span>, and
+ if included the GID of GROUP. Exit if the privileges are not
+ sufficient to do so. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class="EMPHASIS">--chroot</i></span>
+ </p>
+ <p>
+ Before changing to the user ID given in the <span class=
+ "emphasis"><i class="EMPHASIS">--user</i></span> option, chroot
+ to that user's home directory, i.e. make the kernel pretend to
+ the <span class="APPLICATION">Privoxy</span> process that the
+ directory tree starts there. If set up carefully, this can
+ limit the impact of possible vulnerabilities in <span class=
+ "APPLICATION">Privoxy</span> to the files contained in that
+ hierarchy. Unix only.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class=
+ "EMPHASIS">--pre-chroot-nslookup hostname</i></span>
+ </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
+ /etc/resolv.conf) can resolve without recursion (that is,
+ without having to ask any other name servers). The hostname
+ need not exist, but if it doesn't, an error message (which can
+ be ignored) will be output.
+ </p>
+ </li>
+ <li>
+ <p>
+ <span class="emphasis"><i class=
+ "EMPHASIS">configfile</i></span>
+ </p>
+ <p>
+ If no <span class="emphasis"><i class=
+ "EMPHASIS">configfile</i></span> 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. If no config file is found, <span class=
+ "APPLICATION">Privoxy</span> will fail to start.
+ </p>
+ </li>
+ </ul>
+
+ <p>
+ On <span class="APPLICATION">MS Windows</span> only there are two
+ additional command-line options to allow <span class=
+ "APPLICATION">Privoxy</span> to install and run as a <span class=
+ "emphasis"><i class="EMPHASIS">service</i></span>. See the <a href=
+ "installation.html#INSTALLATION-PACK-WIN">Window Installation
+ section</a> for details.
+ </p>
+ </div>