doc/webserver/user-manual/startup.html

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