1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >Starting Privoxy</TITLE
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
10 TITLE="Privoxy 3.0.27 User Manual"
11 HREF="index.html"><LINK
13 TITLE="Quickstart to Using Privoxy"
14 HREF="quickstart.html"><LINK
16 TITLE="Privoxy Configuration"
17 HREF="configuration.html"><LINK
20 HREF="../p_doc.css"><META
21 HTTP-EQUIV="Content-Type"
24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
36 SUMMARY="Header navigation table"
45 >Privoxy 3.0.27 User Manual</TH
53 HREF="quickstart.html"
67 HREF="configuration.html"
82 >5. Starting Privoxy</A
85 > Before launching <SPAN
88 > for the first time, you
89 will want to configure your browser(s) to use
93 > as a HTTP and HTTPS (SSL)
95 HREF="http://en.wikipedia.org/wiki/Proxy_server"
99 127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions
100 used port 8000). This is the one configuration step <SPAN
104 >that must be done</I
108 > Please note that <SPAN
111 > can only proxy HTTP and
112 HTTPS traffic. It will not work with FTP or other protocols.</P
120 >Figure 2. Proxy Configuration Showing
121 Mozilla/Netscape HTTP and HTTPS (SSL) Settings</B
127 SRC="proxy_setup.jpg"></P
134 >, this is typically set under:</P
136 CLASS="LITERALLAYOUT"
140 > -> <SPAN
143 > -> <SPAN
146 > -> <SPAN
152 > -> <SPAN
157 > Or optionally on some platforms:</P
159 CLASS="LITERALLAYOUT"
163 > -> <SPAN
166 > -> <SPAN
169 > -> <SPAN
171 >Connection Settings</SPAN
172 > -> <SPAN
174 >Manual Proxy Configuration</SPAN
184 >), this can be set under:</P
186 CLASS="LITERALLAYOUT"
190 > -> <SPAN
193 > -> <SPAN
196 > -> <SPAN
199 > -> <SPAN
206 >Internet Explorer v.5-7</SPAN
209 CLASS="LITERALLAYOUT"
213 > -> <SPAN
215 >Internet Options</SPAN
216 > -> <SPAN
219 > -> <SPAN
227 > and fill in the appropriate info
228 (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS
229 proxy support too (sometimes labeled <SPAN
233 checkboxes like <SPAN
235 >"Use the same proxy server for all protocols"</SPAN
243 >. You want only HTTP and HTTPS (SSL)!</P
251 >Figure 3. Proxy Configuration Showing
252 Internet Explorer HTTP and HTTPS (Secure) Settings</B
262 > After doing this, flush your browser's disk and memory caches to force a
263 re-reading of all pages and to get rid of any ads that may be cached. Remove
265 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
272 > to manage that. You are now
273 ready to start enjoying the benefits of using
282 > itself is typically started by specifying the
283 main configuration file to be used on the command line. If no configuration
284 file is specified on the command line, <SPAN
288 will look for a file named <TT
292 directory. Except on Win32 where it will try <TT
305 > We use a script. Note that Debian typically starts <SPAN
309 default. It will use the file
312 >/etc/privoxy/config</TT
313 > as its main configuration
323 > # /etc/init.d/privoxy start</PRE
334 >5.2. FreeBSD and ElectroBSD</A
341 "privoxy_enable='YES'" to <TT
351 >/usr/local/etc/privoxy/config</TT
353 configuration file.</P
355 > If you installed <SPAN
359 paths above are relative to the jail root.</P
373 > # service privoxy onestart</PRE
390 > Icon to start <SPAN
393 >. If no configuration file is
394 specified on the command line, <SPAN
401 >. Note that Windows will
402 automatically start <SPAN
405 > when the system starts if you chose that option
411 > can run with full Windows service functionality.
412 On Windows only, the <SPAN
415 > program has two new command line arguments
416 to install and uninstall <SPAN
419 > as a service. See the
421 HREF="installation.html#INSTALLATION-PACK-WIN"
422 >Windows Installation
432 >5.4. Generic instructions for Unix derivates (Solaris, NetBSD, HP-UX etc.)</A
435 >Example Unix startup command:</P
444 > # /usr/sbin/privoxy --user privoxy /etc/privoxy/config</PRE
449 > Note that if you installed <SPAN
453 a package manager, the package will probably contain a platform-specific
454 script or configuration file to start <SPAN
469 > During installation, <SPAN
473 start automatically when the system restarts. You can start it manually by
474 double-clicking on the <SPAN
492 > The privoxy service will automatically start after a successful installation
493 (and thereafter every time your computer starts up) however you will need to
494 configure your web browser(s) to use it. To do so, configure them to use a
495 proxy for HTTP and HTTPS at the address 127.0.0.1:8118.</P
497 > To prevent the privoxy service from automatically starting when your computer
498 starts up, remove or rename the file <TT
500 >/Library/LaunchDaemons/org.ijbswa.privoxy.plist</TT
502 (on OS X 10.5 and higher) or the folder named
505 >/Library/StartupItems/Privoxy</TT
506 > (on OS X 10.4 'Tiger').</P
508 > To manually start or stop the privoxy service, use the scripts startPrivoxy.sh
509 and stopPrivoxy.sh supplied in /Applications/Privoxy. They must be run from an
510 administrator account, using sudo.</P
518 >5.7. Command Line Options</A
524 > may be invoked with the following
525 command-line options:</P
540 > Exit after loading the configuration files before binding to
541 the listen address. The exit code signals whether or not the
542 configuration files have been successfully loaded.
545 > If the exit code is 1, at least one of the configuration files
546 is invalid, if it is 0, all the configuration files have been
547 successfully loaded (but may still contain errors that can
548 currently only be detected at run time).
551 > This option doesn't affect the log setting, combination with
558 > is recommended if a configured
559 log file shouldn't be used.
573 > Print version info and exit. Unix only.
587 > Print short usage info and exit. Unix only.
601 > Don't become a daemon, i.e. don't fork and become process group
602 leader, and don't detach from controlling tty. Unix only.
616 > On startup, write the process ID to <SPAN
629 > on exit. Failure to create or delete the
636 > is non-fatal. If no <SPAN
643 option is given, no PID file will be used. Unix only.
652 >--user USER[.GROUP]</I
657 > After (optionally) writing the PID file, assume the user ID of
664 >, and if included the GID of GROUP. Exit if the
665 privileges are not sufficient to do so. Unix only.
679 > Before changing to the user ID given in the <SPAN
686 chroot to that user's home directory, i.e. make the kernel pretend to the <SPAN
690 process that the directory tree starts there. If set up carefully, this can limit
691 the impact of possible vulnerabilities in <SPAN
694 > to the files contained in that hierarchy.
704 >--pre-chroot-nslookup hostname</I
709 > Specifies a hostname (for example www.privoxy.org) to look up before doing a chroot.
710 On some systems, initializing the resolver library involves reading config files from
711 /etc and/or loading additional shared libraries from /lib.
712 On these systems, doing a hostname lookup before the chroot reduces
713 the number of files that must be copied into the chroot tree.
716 > For fastest startup speed, a good value is a hostname that is not in /etc/hosts but that
717 your local name server (listed in /etc/resolv.conf) can resolve without recursion
718 (that is, without having to ask any other name servers). The hostname need not exist,
719 but if it doesn't, an error message (which can be ignored) will be output.
739 > is included on the command line,
743 > will look for a file named
747 > in the current directory (except on Win32
748 where it will look for <SPAN
752 full path to avoid confusion. If no config file is found,
756 > will fail to start.
764 > only there are two additional
765 command-line options to allow <SPAN
777 HREF="installation.html#INSTALLATION-PACK-WIN"
778 >Window Installation section</A
788 SUMMARY="Footer navigation table"
799 HREF="quickstart.html"
817 HREF="configuration.html"
827 >Quickstart to Using Privoxy</TD
837 >Privoxy Configuration</TD