doc/webserver/user-manual/startup.html

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