doc/webserver/user-manual/startup.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Starting Privoxy</TITLE
   5 ><META
   6 NAME="GENERATOR"
   7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.4 User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Quickstart to Using Privoxy"
  14 HREF="quickstart.html"><LINK
  15 REL="NEXT"
  16 TITLE="Privoxy Configuration"
  17 HREF="configuration.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css">
  21 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
  22 </head
  23 ><BODY
  24 CLASS="SECT1"
  25 BGCOLOR="#EEEEEE"
  26 TEXT="#000000"
  27 LINK="#0000FF"
  28 VLINK="#840084"
  29 ALINK="#0000FF"
  30 ><DIV
  31 CLASS="NAVHEADER"
  32 ><TABLE
  33 SUMMARY="Header navigation table"
  34 WIDTH="100%"
  35 BORDER="0"
  36 CELLPADDING="0"
  37 CELLSPACING="0"
  38 ><TR
  39 ><TH
  40 COLSPAN="3"
  41 ALIGN="center"
  42 >Privoxy 3.0.4 User Manual</TH
  43 ></TR
  44 ><TR
  45 ><TD
  46 WIDTH="10%"
  47 ALIGN="left"
  48 VALIGN="bottom"
  49 ><A
  50 HREF="quickstart.html"
  51 ACCESSKEY="P"
  52 >Prev</A
  53 ></TD
  54 ><TD
  55 WIDTH="80%"
  56 ALIGN="center"
  57 VALIGN="bottom"
  58 ></TD
  59 ><TD
  60 WIDTH="10%"
  61 ALIGN="right"
  62 VALIGN="bottom"
  63 ><A
  64 HREF="configuration.html"
  65 ACCESSKEY="N"
  66 >Next</A
  67 ></TD
  68 ></TR
  69 ></TABLE
  70 ><HR
  71 ALIGN="LEFT"
  72 WIDTH="100%"></DIV
  73 ><DIV
  74 CLASS="SECT1"
  75 ><H1
  76 CLASS="SECT1"
  77 ><A
  78 NAME="STARTUP"
  79 ></A
  80 >5. Starting <SPAN
  81 CLASS="APPLICATION"
  82 >Privoxy</SPAN
  83 ></H1
  84 ><P
  85 > Before launching <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy</SPAN
  88 > for the first time, you
  89  will want to configure your browser(s) to use
  90  <SPAN
  91 CLASS="APPLICATION"
  92 >Privoxy</SPAN
  93 > as a HTTP and HTTPS proxy. The default is
  94  127.0.0.1 (or localhost) for the proxy address, and port 8118 (earlier versions
  95  used port 8000). This is the one configuration step that must be done!</P
  96 ><P
  97 > Please note that <SPAN
  98 CLASS="APPLICATION"
  99 >Privoxy</SPAN
 100 > can only proxy HTTP and
 101  HTTPS traffic. It will not work with FTP or other protocols.</P
 102 ><P
 103 >  <DIV
 104 CLASS="FIGURE"
 105 ><A
 106 NAME="AEN604"
 107 ></A
 108 ><P
 109 ><B
 110 >Figure 2. Proxy Configuration (Mozilla)</B
 111 ></P
 112 ><DIV
 113 CLASS="MEDIAOBJECT"
 114 ><P
 115 ><IMG
 116 SRC="../images/proxy_setup.jpg"></P
 117 ></DIV
 118 ></DIV
 119 >
 120  </P
 121 ><P
 122 >
 123  With <SPAN
 124 CLASS="APPLICATION"
 125 >Firefox</SPAN
 126 >, this can be set under:</P
 127 ><P
 128 CLASS="LITERALLAYOUT"
 129 >&nbsp;<SPAN
 130 CLASS="GUIBUTTON"
 131 >Tools</SPAN
 132 ><br>
 133 &nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;<br>
 134 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 135 CLASS="GUIBUTTON"
 136 >Options</SPAN
 137 ><br>
 138 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 139 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 140 CLASS="GUIBUTTON"
 141 >General</SPAN
 142 ><br>
 143 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 144 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 145 CLASS="GUIBUTTON"
 146 >Connection Settings</SPAN
 147 ><br>
 148 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 149 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 150 CLASS="GUIBUTTON"
 151 >Manual Proxy Configuration</SPAN
 152 ></P
 153 ><P
 154 >
 155  With <SPAN
 156 CLASS="APPLICATION"
 157 >Netscape</SPAN
 158 > (and
 159  <SPAN
 160 CLASS="APPLICATION"
 161 >Mozilla</SPAN
 162 >), this can be set under:</P
 163 ><P
 164 CLASS="LITERALLAYOUT"
 165 >&nbsp;<SPAN
 166 CLASS="GUIBUTTON"
 167 >Edit</SPAN
 168 ><br>
 169 &nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;<br>
 170 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 171 CLASS="GUIBUTTON"
 172 >Preferences</SPAN
 173 ><br>
 174 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 175 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 176 CLASS="GUIBUTTON"
 177 >Advanced</SPAN
 178 ><br>
 179 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 180 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 181 CLASS="GUIBUTTON"
 182 >Proxies</SPAN
 183 ><br>
 184 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 185 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 186 CLASS="GUIBUTTON"
 187 >HTTP Proxy</SPAN
 188 ></P
 189 ><P
 190 > For <SPAN
 191 CLASS="APPLICATION"
 192 >Internet Explorer</SPAN
 193 >: </P
 194 ><P
 195 CLASS="LITERALLAYOUT"
 196 >&nbsp;<SPAN
 197 CLASS="GUIBUTTON"
 198 >Tools</SPAN
 199 ><br>
 200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;<br>
 201 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 202 CLASS="GUIBUTTON"
 203 >Internet Properties</SPAN
 204 ><br>
 205 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 206 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 207 CLASS="GUIBUTTON"
 208 >Connections</SPAN
 209 ><br>
 210 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|_&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
 211 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
 212 CLASS="GUIBUTTON"
 213 >LAN Settings</SPAN
 214 ></P
 215 ><P
 216 > Then, check <SPAN
 217 CLASS="QUOTE"
 218 >"Use Proxy"</SPAN
 219 > and fill in the appropriate info
 220  (Address: 127.0.0.1, Port: 8118). Include HTTPS (SSL), if you want HTTPS
 221  proxy support too. </P
 222 ><P
 223 > After doing this, flush your browser's disk and memory caches to force a
 224  re-reading of all pages and to get rid of any ads that may be cached. You
 225  are now ready to start enjoying the benefits of using
 226  <SPAN
 227 CLASS="APPLICATION"
 228 >Privoxy</SPAN
 229 >!</P
 230 ><P
 231 > <SPAN
 232 CLASS="APPLICATION"
 233 >Privoxy</SPAN
 234 > itself is typically started by specifying the
 235  main configuration file to be used on the command line. If no configuration
 236  file is specified on the command line, <SPAN
 237 CLASS="APPLICATION"
 238 >Privoxy</SPAN
 239 >
 240  will look for a file named <TT
 241 CLASS="FILENAME"
 242 >config</TT
 243 > in the current
 244  directory. Except on Win32 where it will try <TT
 245 CLASS="FILENAME"
 246 >config.txt</TT
 247 >.</P
 248 ><DIV
 249 CLASS="SECT2"
 250 ><H2
 251 CLASS="SECT2"
 252 ><A
 253 NAME="START-REDHAT"
 254 ></A
 255 >5.1. Red Hat and Conectiva</H2
 256 ><P
 257 > We use a script. Note that Red Hat does not start Privoxy upon booting per
 258  default. It will use the file <TT
 259 CLASS="FILENAME"
 260 >/etc/privoxy/config</TT
 261 > as
 262  its main configuration file.</P
 263 ><P
 264 > <TABLE
 265 BORDER="0"
 266 BGCOLOR="#E0E0E0"
 267 WIDTH="100%"
 268 ><TR
 269 ><TD
 270 ><PRE
 271 CLASS="SCREEN"
 272 > # /etc/rc.d/init.d/privoxy start</PRE
 273 ></TD
 274 ></TR
 275 ></TABLE
 276 ></P
 277 ></DIV
 278 ><DIV
 279 CLASS="SECT2"
 280 ><H2
 281 CLASS="SECT2"
 282 ><A
 283 NAME="START-DEBIAN"
 284 ></A
 285 >5.2. Debian</H2
 286 ><P
 287 > We use a script. Note that Debian starts Privoxy upon booting per
 288  default.  It will use the file
 289  <TT
 290 CLASS="FILENAME"
 291 >/etc/privoxy/config</TT
 292 > as its main configuration
 293  file.</P
 294 ><P
 295 > <TABLE
 296 BORDER="0"
 297 BGCOLOR="#E0E0E0"
 298 WIDTH="100%"
 299 ><TR
 300 ><TD
 301 ><PRE
 302 CLASS="SCREEN"
 303 > # /etc/init.d/privoxy start</PRE
 304 ></TD
 305 ></TR
 306 ></TABLE
 307 ></P
 308 ></DIV
 309 ><DIV
 310 CLASS="SECT2"
 311 ><H2
 312 CLASS="SECT2"
 313 ><A
 314 NAME="START-SUSE"
 315 ></A
 316 >5.3. SuSE</H2
 317 ><P
 318 >We use a script. It will use the file <TT
 319 CLASS="FILENAME"
 320 >/etc/privoxy/config</TT
 321 >
 322 as its main configuration file. Note that SuSE starts Privoxy upon booting
 323 your PC.</P
 324 ><P
 325 > <TABLE
 326 BORDER="0"
 327 BGCOLOR="#E0E0E0"
 328 WIDTH="100%"
 329 ><TR
 330 ><TD
 331 ><PRE
 332 CLASS="SCREEN"
 333 > # rcprivoxy start</PRE
 334 ></TD
 335 ></TR
 336 ></TABLE
 337 ></P
 338 ></DIV
 339 ><DIV
 340 CLASS="SECT2"
 341 ><H2
 342 CLASS="SECT2"
 343 ><A
 344 NAME="START-WINDOWS"
 345 ></A
 346 >5.4. Windows</H2
 347 ><P
 348 >Click on the Privoxy Icon to start <SPAN
 349 CLASS="APPLICATION"
 350 >Privoxy</SPAN
 351 >. If no configuration file is
 352  specified on the command line, <SPAN
 353 CLASS="APPLICATION"
 354 >Privoxy</SPAN
 355 > will look
 356  for a file named <TT
 357 CLASS="FILENAME"
 358 >config.txt</TT
 359 >. Note that Windows will
 360  automatically start Privoxy when the system starts if you chose that option
 361  when installing.</P
 362 ><P
 363 > <SPAN
 364 CLASS="APPLICATION"
 365 >Privoxy</SPAN
 366 > can run with full Windows service functionality.
 367  On Windows only, the Privoxy program has two new command line arguments
 368  to install and uninstall Privoxy as a service. See the
 369  <A
 370 HREF="installation.html#INSTALLATION-PACK-WIN"
 371 >Windows Installation
 372  instructions</A
 373 > for details.</P
 374 ></DIV
 375 ><DIV
 376 CLASS="SECT2"
 377 ><H2
 378 CLASS="SECT2"
 379 ><A
 380 NAME="START-UNICES"
 381 ></A
 382 >5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</H2
 383 ><P
 384 >Example Unix startup command:</P
 385 ><P
 386 > <TABLE
 387 BORDER="0"
 388 BGCOLOR="#E0E0E0"
 389 WIDTH="100%"
 390 ><TR
 391 ><TD
 392 ><PRE
 393 CLASS="SCREEN"
 394 > # /usr/sbin/privoxy /etc/privoxy/config</PRE
 395 ></TD
 396 ></TR
 397 ></TABLE
 398 ></P
 399 ></DIV
 400 ><DIV
 401 CLASS="SECT2"
 402 ><H2
 403 CLASS="SECT2"
 404 ><A
 405 NAME="START-OS2"
 406 ></A
 407 >5.6. OS/2</H2
 408 ><P
 409 > During installation, <SPAN
 410 CLASS="APPLICATION"
 411 >Privoxy</SPAN
 412 > is configured to
 413  start automatically when the system restarts. You can start it manually by
 414  double-clicking on the <SPAN
 415 CLASS="APPLICATION"
 416 >Privoxy</SPAN
 417 > icon in the
 418  <SPAN
 419 CLASS="APPLICATION"
 420 >Privoxy</SPAN
 421 > folder.</P
 422 ></DIV
 423 ><DIV
 424 CLASS="SECT2"
 425 ><H2
 426 CLASS="SECT2"
 427 ><A
 428 NAME="START-MACOSX"
 429 ></A
 430 >5.7. Mac OSX</H2
 431 ><P
 432 > During installation, <SPAN
 433 CLASS="APPLICATION"
 434 >Privoxy</SPAN
 435 > is configured to
 436  start automatically when the system restarts.  To start Privoxy by hand,
 437  double-click on the <TT
 438 CLASS="LITERAL"
 439 >StartPrivoxy.command</TT
 440 > icon in the
 441  <TT
 442 CLASS="LITERAL"
 443 >/Library/Privoxy</TT
 444 > folder.  Or, type this command
 445  in the Terminal:</P
 446 ><P
 447 >  <TABLE
 448 BORDER="0"
 449 BGCOLOR="#E0E0E0"
 450 WIDTH="100%"
 451 ><TR
 452 ><TD
 453 ><PRE
 454 CLASS="SCREEN"
 455 >  /Library/Privoxy/StartPrivoxy.command
 456   </PRE
 457 ></TD
 458 ></TR
 459 ></TABLE
 460 ></P
 461 ><P
 462 > You will be prompted for the administrator password.</P
 463 ></DIV
 464 ><DIV
 465 CLASS="SECT2"
 466 ><H2
 467 CLASS="SECT2"
 468 ><A
 469 NAME="START-AMIGAOS"
 470 ></A
 471 >5.8. AmigaOS</H2
 472 ><P
 473 > Start <SPAN
 474 CLASS="APPLICATION"
 475 >Privoxy</SPAN
 476 > (with RUN &#60;&#62;NIL:) in your
 477  <TT
 478 CLASS="FILENAME"
 479 >startnet</TT
 480 > script (AmiTCP), in
 481  <TT
 482 CLASS="FILENAME"
 483 >s:user-startup</TT
 484 > (RoadShow), as startup program in your
 485  startup script (Genesis), or as startup action (Miami and MiamiDx).
 486  <SPAN
 487 CLASS="APPLICATION"
 488 >Privoxy</SPAN
 489 > will automatically quit when you quit your
 490  TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that
 491  <SPAN
 492 CLASS="APPLICATION"
 493 >Privoxy</SPAN
 494 > is still running).</P
 495 ></DIV
 496 ><DIV
 497 CLASS="SECT2"
 498 ><H2
 499 CLASS="SECT2"
 500 ><A
 501 NAME="START-GENTOO"
 502 ></A
 503 >5.9. Gentoo</H2
 504 ><P
 505 > A script is again used. It will use the file <TT
 506 CLASS="FILENAME"
 507 >/etc/privoxy/config
 508  </TT
 509 > as its main configuration file.</P
 510 ><P
 511 > <TABLE
 512 BORDER="0"
 513 BGCOLOR="#E0E0E0"
 514 WIDTH="100%"
 515 ><TR
 516 ><TD
 517 ><PRE
 518 CLASS="SCREEN"
 519 > /etc/init.d/privoxy start
 520  </PRE
 521 ></TD
 522 ></TR
 523 ></TABLE
 524 ></P
 525 ><P
 526 > Note that <SPAN
 527 CLASS="APPLICATION"
 528 >Privoxy</SPAN
 529 > is not automatically started at
 530  boot time by default. You can change this with the <TT
 531 CLASS="LITERAL"
 532 >rc-update</TT
 533 >
 534  command.</P
 535 ><P
 536 >
 537  <TABLE
 538 BORDER="0"
 539 BGCOLOR="#E0E0E0"
 540 WIDTH="100%"
 541 ><TR
 542 ><TD
 543 ><PRE
 544 CLASS="SCREEN"
 545 > rc-update add privoxy default
 546  </PRE
 547 ></TD
 548 ></TR
 549 ></TABLE
 550 ></P
 551 ></DIV
 552 ><DIV
 553 CLASS="SECT2"
 554 ><H2
 555 CLASS="SECT2"
 556 ><A
 557 NAME="CMDOPTIONS"
 558 ></A
 559 >5.10. Command Line Options</H2
 560 ><P
 561 > <SPAN
 562 CLASS="APPLICATION"
 563 >Privoxy</SPAN
 564 > may be invoked with the following
 565  command-line options:</P
 566 ><P
 567 > <P
 568 ></P
 569 ><UL
 570 ><LI
 571 ><P
 572 >    <SPAN
 573 CLASS="emphasis"
 574 ><I
 575 CLASS="EMPHASIS"
 576 >--version</I
 577 ></SPAN
 578 >
 579   </P
 580 ><P
 581 >     Print version info and exit. Unix only.
 582   </P
 583 ></LI
 584 ><LI
 585 ><P
 586 >    <SPAN
 587 CLASS="emphasis"
 588 ><I
 589 CLASS="EMPHASIS"
 590 >--help</I
 591 ></SPAN
 592 >
 593   </P
 594 ><P
 595 >   Print short usage info and exit. Unix only.
 596   </P
 597 ></LI
 598 ><LI
 599 ><P
 600 >   <SPAN
 601 CLASS="emphasis"
 602 ><I
 603 CLASS="EMPHASIS"
 604 >--no-daemon</I
 605 ></SPAN
 606 >
 607   </P
 608 ><P
 609 >   Don't become a daemon, i.e. don't fork and become process group
 610    leader, and don't detach from controlling tty. Unix only.
 611   </P
 612 ></LI
 613 ><LI
 614 ><P
 615 >   <SPAN
 616 CLASS="emphasis"
 617 ><I
 618 CLASS="EMPHASIS"
 619 >--pidfile FILE</I
 620 ></SPAN
 621 >
 622
 623   </P
 624 ><P
 625 >   On startup, write the process ID to <SPAN
 626 CLASS="emphasis"
 627 ><I
 628 CLASS="EMPHASIS"
 629 >FILE</I
 630 ></SPAN
 631 >. Delete the
 632    <SPAN
 633 CLASS="emphasis"
 634 ><I
 635 CLASS="EMPHASIS"
 636 >FILE</I
 637 ></SPAN
 638 > on exit. Failure to create or delete the
 639    <SPAN
 640 CLASS="emphasis"
 641 ><I
 642 CLASS="EMPHASIS"
 643 >FILE</I
 644 ></SPAN
 645 > is non-fatal. If no <SPAN
 646 CLASS="emphasis"
 647 ><I
 648 CLASS="EMPHASIS"
 649 >FILE</I
 650 ></SPAN
 651 >
 652    option is given, no PID file will be used. Unix only.
 653   </P
 654 ></LI
 655 ><LI
 656 ><P
 657 >   <SPAN
 658 CLASS="emphasis"
 659 ><I
 660 CLASS="EMPHASIS"
 661 >--user USER[.GROUP]</I
 662 ></SPAN
 663 >
 664
 665   </P
 666 ><P
 667 >   After (optionally) writing the PID file, assume the user  ID  of
 668    <SPAN
 669 CLASS="emphasis"
 670 ><I
 671 CLASS="EMPHASIS"
 672 >USER</I
 673 ></SPAN
 674 >, and if included the GID of GROUP.  Exit if the
 675    privileges are not sufficient to do so. Unix only.
 676   </P
 677 ></LI
 678 ><LI
 679 ><P
 680 >   <SPAN
 681 CLASS="emphasis"
 682 ><I
 683 CLASS="EMPHASIS"
 684 >--chroot</I
 685 ></SPAN
 686 >
 687
 688   </P
 689 ><P
 690 >   Before changing to the user ID given in the <SPAN
 691 CLASS="emphasis"
 692 ><I
 693 CLASS="EMPHASIS"
 694 >--user</I
 695 ></SPAN
 696 > option,
 697    chroot to that user's home directory, i.e. make the kernel pretend to the Privoxy
 698    process that the directory tree starts there. If set up carefully, this can limit
 699    the impact of possible vulnerabilities in Privoxy to the files contained in that hierarchy.
 700    Unix only.
 701   </P
 702 ></LI
 703 ><LI
 704 ><P
 705 >    <SPAN
 706 CLASS="emphasis"
 707 ><I
 708 CLASS="EMPHASIS"
 709 >configfile</I
 710 ></SPAN
 711 >
 712   </P
 713 ><P
 714 >    If no <SPAN
 715 CLASS="emphasis"
 716 ><I
 717 CLASS="EMPHASIS"
 718 >configfile</I
 719 ></SPAN
 720 > is included on the command line,
 721     <SPAN
 722 CLASS="APPLICATION"
 723 >Privoxy</SPAN
 724 > will look for a file named
 725     <SPAN
 726 CLASS="QUOTE"
 727 >"config"</SPAN
 728 > in the current directory (except on Win32
 729     where it will look for <SPAN
 730 CLASS="QUOTE"
 731 >"config.txt"</SPAN
 732 > instead). Specify
 733     full path to avoid confusion. If no config file is found,
 734     <SPAN
 735 CLASS="APPLICATION"
 736 >Privoxy</SPAN
 737 > will fail to start.
 738   </P
 739 ></LI
 740 ></UL
 741 ></P
 742 ><P
 743 > On <SPAN
 744 CLASS="APPLICATION"
 745 >MS Windows</SPAN
 746 > only there are two addition
 747  options to allow <SPAN
 748 CLASS="APPLICATION"
 749 >Privoxy</SPAN
 750 > to install and
 751  run as a <SPAN
 752 CLASS="emphasis"
 753 ><I
 754 CLASS="EMPHASIS"
 755 >service</I
 756 ></SPAN
 757 >. See the
 758 <A
 759 HREF="installation.html#INSTALLATION-PACK-WIN"
 760 >Window Installation section</A
 761 >
 762 for details.</P
 763 ></DIV
 764 ></DIV
 765 ><DIV
 766 CLASS="NAVFOOTER"
 767 ><HR
 768 ALIGN="LEFT"
 769 WIDTH="100%"><TABLE
 770 SUMMARY="Footer navigation table"
 771 WIDTH="100%"
 772 BORDER="0"
 773 CELLPADDING="0"
 774 CELLSPACING="0"
 775 ><TR
 776 ><TD
 777 WIDTH="33%"
 778 ALIGN="left"
 779 VALIGN="top"
 780 ><A
 781 HREF="quickstart.html"
 782 ACCESSKEY="P"
 783 >Prev</A
 784 ></TD
 785 ><TD
 786 WIDTH="34%"
 787 ALIGN="center"
 788 VALIGN="top"
 789 ><A
 790 HREF="index.html"
 791 ACCESSKEY="H"
 792 >Home</A
 793 ></TD
 794 ><TD
 795 WIDTH="33%"
 796 ALIGN="right"
 797 VALIGN="top"
 798 ><A
 799 HREF="configuration.html"
 800 ACCESSKEY="N"
 801 >Next</A
 802 ></TD
 803 ></TR
 804 ><TR
 805 ><TD
 806 WIDTH="33%"
 807 ALIGN="left"
 808 VALIGN="top"
 809 >Quickstart to Using <SPAN
 810 CLASS="APPLICATION"
 811 >Privoxy</SPAN
 812 ></TD
 813 ><TD
 814 WIDTH="34%"
 815 ALIGN="center"
 816 VALIGN="top"
 817 >&nbsp;</TD
 818 ><TD
 819 WIDTH="33%"
 820 ALIGN="right"
 821 VALIGN="top"
 822 ><SPAN
 823 CLASS="APPLICATION"
 824 >Privoxy</SPAN
 825 > Configuration</TD
 826 ></TR
 827 ></TABLE
 828 ></DIV
 829 ></BODY
 830 ></HTML
 831 >