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.16 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.16 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
121 >Figure 2. Proxy Configuration Showing
122 Mozilla/Netscape HTTP and HTTPS (SSL) Settings</B
128 SRC="proxy_setup.jpg"></P
138 >, this is typically set under:</P
140 CLASS="LITERALLAYOUT"
144 > -> <SPAN
147 > -> <SPAN
150 > -> <SPAN
156 > -> <SPAN
162 Or optionally on some platforms:</P
164 CLASS="LITERALLAYOUT"
168 > -> <SPAN
171 > -> <SPAN
174 > -> <SPAN
176 >Connection Settings</SPAN
177 > -> <SPAN
179 >Manual Proxy Configuration</SPAN
190 >), this can be set under:</P
192 CLASS="LITERALLAYOUT"
196 > -> <SPAN
199 > -> <SPAN
202 > -> <SPAN
205 > -> <SPAN
212 >Internet Explorer v.5-7</SPAN
215 CLASS="LITERALLAYOUT"
219 > -> <SPAN
221 >Internet Options</SPAN
222 > -> <SPAN
225 > -> <SPAN
233 > and fill in the appropriate info
234 (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS
235 proxy support too (sometimes labeled <SPAN
239 checkboxes like <SPAN
241 >"Use the same proxy server for all protocols"</SPAN
249 >. You want only HTTP and HTTPS (SSL)!</P
258 >Figure 3. Proxy Configuration Showing
259 Internet Explorer HTTP and HTTPS (Secure) Settings</B
271 > After doing this, flush your browser's disk and memory caches to force a
272 re-reading of all pages and to get rid of any ads that may be cached. Remove
274 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
281 > to manage that. You are now
282 ready to start enjoying the benefits of using
291 > itself is typically started by specifying the
292 main configuration file to be used on the command line. If no configuration
293 file is specified on the command line, <SPAN
297 will look for a file named <TT
301 directory. Except on Win32 where it will try <TT
311 >5.1. Red Hat and Fedora</A
314 > A default Red Hat installation may not start <SPAN
317 > upon boot. It will use
320 >/etc/privoxy/config</TT
321 > as its main configuration
332 > # /etc/rc.d/init.d/privoxy start</PRE
348 > # service privoxy start</PRE
363 > We use a script. Note that Debian typically starts <SPAN
367 default. It will use the file
370 >/etc/privoxy/config</TT
371 > as its main configuration
382 > # /etc/init.d/privoxy start</PRE
400 > Icon to start <SPAN
403 >. If no configuration file is
404 specified on the command line, <SPAN
411 >. Note that Windows will
412 automatically start <SPAN
415 > when the system starts if you chose that option
421 > can run with full Windows service functionality.
422 On Windows only, the <SPAN
425 > program has two new command line arguments
426 to install and uninstall <SPAN
429 > as a service. See the
431 HREF="installation.html#INSTALLATION-PACK-WIN"
432 >Windows Installation
442 >5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
445 >Example Unix startup command:</P
455 > # /usr/sbin/privoxy /etc/privoxy/config</PRE
470 > During installation, <SPAN
474 start automatically when the system restarts. You can start it manually by
475 double-clicking on the <SPAN
493 > After downloading the privoxy software, unzip the downloaded file by
494 double-clicking on the zip file icon. Then, double-click on the
495 installer package icon and follow the installation process.</P
497 > The privoxy service will automatically start after a successful
498 installation. In addition, the privoxy service will automatically
499 start every time your computer starts up.</P
501 > To prevent the privoxy service from automatically starting when your
502 computer starts up, remove or rename the folder named
503 /Library/StartupItems/Privoxy.</P
505 > A simple application named Privoxy Utility has been created which
506 enables administrators to easily start and stop the privoxy service.</P
508 > In addition, the Privoxy Utility presents a simple way for
509 administrators to edit the various privoxy config files. A method
510 to uninstall the software is also available.</P
512 > An administrator username and password must be supplied in order for
513 the Privoxy Utility to perform any of the tasks.</P
527 > (with RUN <>NIL:) in your
531 > script (AmiTCP), in
535 > (RoadShow), as startup program in your
536 startup script (Genesis), or as startup action (Miami and MiamiDx).
540 > will automatically quit when you quit your
541 TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that
545 > is still running).</P
556 > A script is again used. It will use the file <TT
560 > as its main configuration file.</P
570 > /etc/init.d/privoxy start
580 > is not automatically started at
581 boot time by default. You can change this with the <TT
596 > rc-update add privoxy default
609 >5.9. Command Line Options</A
615 > may be invoked with the following
616 command-line options:</P
632 > Print version info and exit. Unix only.
646 > Print short usage info and exit. Unix only.
660 > Don't become a daemon, i.e. don't fork and become process group
661 leader, and don't detach from controlling tty. Unix only.
675 > On startup, write the process ID to <SPAN
688 > on exit. Failure to create or delete the
695 > is non-fatal. If no <SPAN
702 option is given, no PID file will be used. Unix only.
711 >--user USER[.GROUP]</I
716 > After (optionally) writing the PID file, assume the user ID of
723 >, and if included the GID of GROUP. Exit if the
724 privileges are not sufficient to do so. Unix only.
738 > Before changing to the user ID given in the <SPAN
745 chroot to that user's home directory, i.e. make the kernel pretend to the <SPAN
749 process that the directory tree starts there. If set up carefully, this can limit
750 the impact of possible vulnerabilities in <SPAN
753 > to the files contained in that hierarchy.
763 >--pre-chroot-nslookup hostname</I
768 > Specifies a hostname to look up before doing a chroot. On some systems, initializing the
769 resolver library involves reading config files from /etc and/or loading additional shared
770 libraries from /lib. On these systems, doing a hostname lookup before the chroot reduces
771 the number of files that must be copied into the chroot tree.
774 > For fastest startup speed, a good value is a hostname that is not in /etc/hosts but that
775 your local name server (listed in /etc/resolv.conf) can resolve without recursion
776 (that is, without having to ask any other name servers). The hostname need not exist,
777 but if it doesn't, an error message (which can be ignored) will be output.
797 > is included on the command line,
801 > will look for a file named
805 > in the current directory (except on Win32
806 where it will look for <SPAN
810 full path to avoid confusion. If no config file is found,
814 > will fail to start.
823 > only there are two additional
824 command-line options to allow <SPAN
836 HREF="installation.html#INSTALLATION-PACK-WIN"
837 >Window Installation section</A
847 SUMMARY="Footer navigation table"
858 HREF="quickstart.html"
876 HREF="configuration.html"
886 >Quickstart to Using Privoxy</TD
896 >Privoxy Configuration</TD