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.8 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
21 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
33 SUMMARY="Header navigation table"
42 >Privoxy 3.0.8 User Manual</TH
50 HREF="quickstart.html"
64 HREF="configuration.html"
79 >5. Starting Privoxy</A
82 > Before launching <SPAN
85 > for the first time, you
86 will want to configure your browser(s) to use
90 > as a HTTP and HTTPS (SSL)
92 HREF="http://en.wikipedia.org/wiki/Proxy_server"
96 127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions
97 used port 8000). This is the one configuration step <SPAN
101 >that must be done</I
105 > Please note that <SPAN
108 > can only proxy HTTP and
109 HTTPS traffic. It will not work with FTP or other protocols.</P
118 >Figure 2. Proxy Configuration Showing
119 Mozilla/Netscape HTTP and HTTPS (SSL) Settings</B
125 SRC="proxy_setup.jpg"></P
135 >, this is typically set under:</P
137 CLASS="LITERALLAYOUT"
141 > -> <SPAN
144 > -> <SPAN
147 > -> <SPAN
153 > -> <SPAN
159 Or optionally on some platforms:</P
161 CLASS="LITERALLAYOUT"
165 > -> <SPAN
168 > -> <SPAN
171 > -> <SPAN
173 >Connection Settings</SPAN
174 > -> <SPAN
176 >Manual Proxy Configuration</SPAN
187 >), this can be set under:</P
189 CLASS="LITERALLAYOUT"
193 > -> <SPAN
196 > -> <SPAN
199 > -> <SPAN
202 > -> <SPAN
209 >Internet Explorer v.5-6</SPAN
212 CLASS="LITERALLAYOUT"
216 > -> <SPAN
218 >Internet Options</SPAN
219 > -> <SPAN
222 > -> <SPAN
230 > and fill in the appropriate info
231 (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS
232 proxy support too (sometimes labeled <SPAN
236 checkboxes like <SPAN
238 >"Use the same proxy server for all protocols"</SPAN
246 >. You want only HTTP and HTTPS (SSL)!</P
255 >Figure 3. Proxy Configuration Showing
256 Internet Explorer HTTP and HTTPS (Secure) Settings</B
268 > After doing this, flush your browser's disk and memory caches to force a
269 re-reading of all pages and to get rid of any ads that may be cached. Remove
271 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
278 > to manage that. You are now
279 ready to start enjoying the benefits of using
288 > itself is typically started by specifying the
289 main configuration file to be used on the command line. If no configuration
290 file is specified on the command line, <SPAN
294 will look for a file named <TT
298 directory. Except on Win32 where it will try <TT
308 >5.1. Red Hat and Fedora</A
311 > A default Red Hat installation may not start <SPAN
314 > upon boot. It will use
317 >/etc/privoxy/config</TT
318 > as its main configuration
329 > # /etc/rc.d/init.d/privoxy start</PRE
345 > # service privoxy start</PRE
360 > We use a script. Note that Debian typically starts <SPAN
364 default. It will use the file
367 >/etc/privoxy/config</TT
368 > as its main configuration
379 > # /etc/init.d/privoxy start</PRE
397 > Icon to start <SPAN
400 >. If no configuration file is
401 specified on the command line, <SPAN
408 >. Note that Windows will
409 automatically start <SPAN
412 > when the system starts if you chose that option
418 > can run with full Windows service functionality.
419 On Windows only, the <SPAN
422 > program has two new command line arguments
423 to install and uninstall <SPAN
426 > as a service. See the
428 HREF="installation.html#INSTALLATION-PACK-WIN"
429 >Windows Installation
439 >5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
442 >Example Unix startup command:</P
452 > # /usr/sbin/privoxy /etc/privoxy/config</PRE
467 > During installation, <SPAN
471 start automatically when the system restarts. You can start it manually by
472 double-clicking on the <SPAN
490 > During installation, <SPAN
494 start automatically when the system restarts. To start <SPAN
498 double-click on the <TT
500 >StartPrivoxy.command</TT
504 >/Library/Privoxy</TT
505 > folder. Or, type this command
516 > /Library/Privoxy/StartPrivoxy.command
523 > You will be prompted for the administrator password.</P
537 > (with RUN <>NIL:) in your
541 > script (AmiTCP), in
545 > (RoadShow), as startup program in your
546 startup script (Genesis), or as startup action (Miami and MiamiDx).
550 > will automatically quit when you quit your
551 TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that
555 > is still running).</P
566 > A script is again used. It will use the file <TT
570 > as its main configuration file.</P
580 > /etc/init.d/privoxy start
590 > is not automatically started at
591 boot time by default. You can change this with the <TT
606 > rc-update add privoxy default
619 >5.9. Command Line Options</A
625 > may be invoked with the following
626 command-line options:</P
642 > Print version info and exit. Unix only.
656 > Print short usage info and exit. Unix only.
670 > Don't become a daemon, i.e. don't fork and become process group
671 leader, and don't detach from controlling tty. Unix only.
685 > On startup, write the process ID to <SPAN
698 > on exit. Failure to create or delete the
705 > is non-fatal. If no <SPAN
712 option is given, no PID file will be used. Unix only.
721 >--user USER[.GROUP]</I
726 > After (optionally) writing the PID file, assume the user ID of
733 >, and if included the GID of GROUP. Exit if the
734 privileges are not sufficient to do so. Unix only.
748 > Before changing to the user ID given in the <SPAN
755 chroot to that user's home directory, i.e. make the kernel pretend to the <SPAN
759 process that the directory tree starts there. If set up carefully, this can limit
760 the impact of possible vulnerabilities in <SPAN
763 > to the files contained in that hierarchy.
773 >--pre-chroot-nslookup hostname</I
778 > Specifies a hostname to look up before doing a chroot. On some systems, initializing the
779 resolver library involves reading config files from /etc and/or loading additional shared
780 libraries from /lib. On these systems, doing a hostname lookup before the chroot reduces
781 the number of files that must be copied into the chroot tree.
784 > For fastest startup speed, a good value is a hostname that is not in /etc/hosts but that
785 your local name server (listed in /etc/resolv.conf) can resolve without recursion
786 (that is, without having to ask any other name servers). The hostname need not exist,
787 but if it doesn't, an error message (which can be ignored) will be output.
807 > is included on the command line,
811 > will look for a file named
815 > in the current directory (except on Win32
816 where it will look for <SPAN
820 full path to avoid confusion. If no config file is found,
824 > will fail to start.
833 > only there are two additional
834 command-line options to allow <SPAN
846 HREF="installation.html#INSTALLATION-PACK-WIN"
847 >Window Installation section</A
857 SUMMARY="Footer navigation table"
868 HREF="quickstart.html"
886 HREF="configuration.html"
896 >Quickstart to Using Privoxy</TD
906 >Privoxy Configuration</TD