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.13 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.13 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="AEN593"
 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="AEN638"
 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 >  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
 496 ><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
 500 ><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
 504 ><P
 505 >  A simple application named Privoxy Utility has been created which
 506   enables administrators to easily start and stop the privoxy service.</P
 507 ><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
 511 ><P
 512 >  An administrator username and password must be supplied in order for
 513   the Privoxy Utility to perform any of the tasks.</P
 514 ></DIV
 515 ><DIV
 516 CLASS="SECT2"
 517 ><H2
 518 CLASS="SECT2"
 519 ><A
 520 NAME="START-AMIGAOS"
 521 >5.7. AmigaOS</A
 522 ></H2
 523 ><P
 524 > Start <SPAN
 525 CLASS="APPLICATION"
 526 >Privoxy</SPAN
 527 > (with RUN &#60;&#62;NIL:) in your
 528  <TT
 529 CLASS="FILENAME"
 530 >startnet</TT
 531 > script (AmiTCP), in
 532  <TT
 533 CLASS="FILENAME"
 534 >s:user-startup</TT
 535 > (RoadShow), as startup program in your
 536  startup script (Genesis), or as startup action (Miami and MiamiDx).
 537  <SPAN
 538 CLASS="APPLICATION"
 539 >Privoxy</SPAN
 540 > will automatically quit when you quit your
 541  TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that
 542  <SPAN
 543 CLASS="APPLICATION"
 544 >Privoxy</SPAN
 545 > is still running).</P
 546 ></DIV
 547 ><DIV
 548 CLASS="SECT2"
 549 ><H2
 550 CLASS="SECT2"
 551 ><A
 552 NAME="START-GENTOO"
 553 >5.8. Gentoo</A
 554 ></H2
 555 ><P
 556 > A script is again used. It will use the file <TT
 557 CLASS="FILENAME"
 558 >/etc/privoxy/config
 559  </TT
 560 > as its main configuration file.</P
 561 ><P
 562 > <TABLE
 563 BORDER="0"
 564 BGCOLOR="#E0E0E0"
 565 WIDTH="100%"
 566 ><TR
 567 ><TD
 568 ><PRE
 569 CLASS="SCREEN"
 570 > /etc/init.d/privoxy start
 571  </PRE
 572 ></TD
 573 ></TR
 574 ></TABLE
 575 ></P
 576 ><P
 577 > Note that <SPAN
 578 CLASS="APPLICATION"
 579 >Privoxy</SPAN
 580 > is not automatically started at
 581  boot time by default. You can change this with the <TT
 582 CLASS="LITERAL"
 583 >rc-update</TT
 584 >
 585  command.</P
 586 ><P
 587 >
 588  <TABLE
 589 BORDER="0"
 590 BGCOLOR="#E0E0E0"
 591 WIDTH="100%"
 592 ><TR
 593 ><TD
 594 ><PRE
 595 CLASS="SCREEN"
 596 > rc-update add privoxy default
 597  </PRE
 598 ></TD
 599 ></TR
 600 ></TABLE
 601 ></P
 602 ></DIV
 603 ><DIV
 604 CLASS="SECT2"
 605 ><H2
 606 CLASS="SECT2"
 607 ><A
 608 NAME="CMDOPTIONS"
 609 >5.9. Command Line Options</A
 610 ></H2
 611 ><P
 612 > <SPAN
 613 CLASS="APPLICATION"
 614 >Privoxy</SPAN
 615 > may be invoked with the following
 616  command-line options:</P
 617 ><P
 618 > <P
 619 ></P
 620 ><UL
 621 ><LI
 622 ><P
 623 >    <SPAN
 624 CLASS="emphasis"
 625 ><I
 626 CLASS="EMPHASIS"
 627 >--version</I
 628 ></SPAN
 629 >
 630   </P
 631 ><P
 632 >     Print version info and exit. Unix only.
 633   </P
 634 ></LI
 635 ><LI
 636 ><P
 637 >    <SPAN
 638 CLASS="emphasis"
 639 ><I
 640 CLASS="EMPHASIS"
 641 >--help</I
 642 ></SPAN
 643 >
 644   </P
 645 ><P
 646 >   Print short usage info and exit. Unix only.
 647   </P
 648 ></LI
 649 ><LI
 650 ><P
 651 >   <SPAN
 652 CLASS="emphasis"
 653 ><I
 654 CLASS="EMPHASIS"
 655 >--no-daemon</I
 656 ></SPAN
 657 >
 658   </P
 659 ><P
 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.
 662   </P
 663 ></LI
 664 ><LI
 665 ><P
 666 >   <SPAN
 667 CLASS="emphasis"
 668 ><I
 669 CLASS="EMPHASIS"
 670 >--pidfile FILE</I
 671 ></SPAN
 672 >
 673   </P
 674 ><P
 675 >   On startup, write the process ID to <SPAN
 676 CLASS="emphasis"
 677 ><I
 678 CLASS="EMPHASIS"
 679 >FILE</I
 680 ></SPAN
 681 >. Delete the
 682    <SPAN
 683 CLASS="emphasis"
 684 ><I
 685 CLASS="EMPHASIS"
 686 >FILE</I
 687 ></SPAN
 688 > on exit. Failure to create or delete the
 689    <SPAN
 690 CLASS="emphasis"
 691 ><I
 692 CLASS="EMPHASIS"
 693 >FILE</I
 694 ></SPAN
 695 > is non-fatal. If no <SPAN
 696 CLASS="emphasis"
 697 ><I
 698 CLASS="EMPHASIS"
 699 >FILE</I
 700 ></SPAN
 701 >
 702    option is given, no PID file will be used. Unix only.
 703   </P
 704 ></LI
 705 ><LI
 706 ><P
 707 >   <SPAN
 708 CLASS="emphasis"
 709 ><I
 710 CLASS="EMPHASIS"
 711 >--user USER[.GROUP]</I
 712 ></SPAN
 713 >
 714   </P
 715 ><P
 716 >   After (optionally) writing the PID file, assume the user  ID  of
 717    <SPAN
 718 CLASS="emphasis"
 719 ><I
 720 CLASS="EMPHASIS"
 721 >USER</I
 722 ></SPAN
 723 >, and if included the GID of GROUP.  Exit if the
 724    privileges are not sufficient to do so. Unix only.
 725   </P
 726 ></LI
 727 ><LI
 728 ><P
 729 >   <SPAN
 730 CLASS="emphasis"
 731 ><I
 732 CLASS="EMPHASIS"
 733 >--chroot</I
 734 ></SPAN
 735 >
 736   </P
 737 ><P
 738 >   Before changing to the user ID given in the <SPAN
 739 CLASS="emphasis"
 740 ><I
 741 CLASS="EMPHASIS"
 742 >--user</I
 743 ></SPAN
 744 > option,
 745    chroot to that user's home directory, i.e. make the kernel pretend to the <SPAN
 746 CLASS="APPLICATION"
 747 >Privoxy</SPAN
 748 >
 749    process that the directory tree starts there. If set up carefully, this can limit
 750    the impact of possible vulnerabilities in <SPAN
 751 CLASS="APPLICATION"
 752 >Privoxy</SPAN
 753 > to the files contained in that hierarchy.
 754    Unix only.
 755   </P
 756 ></LI
 757 ><LI
 758 ><P
 759 >   <SPAN
 760 CLASS="emphasis"
 761 ><I
 762 CLASS="EMPHASIS"
 763 >--pre-chroot-nslookup hostname</I
 764 ></SPAN
 765 >
 766   </P
 767 ><P
 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.
 772   </P
 773 ><P
 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.
 778   </P
 779 ></LI
 780 ><LI
 781 ><P
 782 >    <SPAN
 783 CLASS="emphasis"
 784 ><I
 785 CLASS="EMPHASIS"
 786 >configfile</I
 787 ></SPAN
 788 >
 789   </P
 790 ><P
 791 >    If no <SPAN
 792 CLASS="emphasis"
 793 ><I
 794 CLASS="EMPHASIS"
 795 >configfile</I
 796 ></SPAN
 797 > is included on the command line,
 798     <SPAN
 799 CLASS="APPLICATION"
 800 >Privoxy</SPAN
 801 > will look for a file named
 802     <SPAN
 803 CLASS="QUOTE"
 804 >"config"</SPAN
 805 > in the current directory (except on Win32
 806     where it will look for <SPAN
 807 CLASS="QUOTE"
 808 >"config.txt"</SPAN
 809 > instead). Specify
 810     full path to avoid confusion. If no config file is found,
 811     <SPAN
 812 CLASS="APPLICATION"
 813 >Privoxy</SPAN
 814 > will fail to start.
 815   </P
 816 ></LI
 817 ></UL
 818 ></P
 819 ><P
 820 > On <SPAN
 821 CLASS="APPLICATION"
 822 >MS Windows</SPAN
 823 > only there are two additional
 824  command-line options to allow <SPAN
 825 CLASS="APPLICATION"
 826 >Privoxy</SPAN
 827 > to install and
 828  run as a <SPAN
 829 CLASS="emphasis"
 830 ><I
 831 CLASS="EMPHASIS"
 832 >service</I
 833 ></SPAN
 834 >. See the
 835 <A
 836 HREF="installation.html#INSTALLATION-PACK-WIN"
 837 >Window Installation section</A
 838 >
 839 for details.</P
 840 ></DIV
 841 ></DIV
 842 ><DIV
 843 CLASS="NAVFOOTER"
 844 ><HR
 845 ALIGN="LEFT"
 846 WIDTH="100%"><TABLE
 847 SUMMARY="Footer navigation table"
 848 WIDTH="100%"
 849 BORDER="0"
 850 CELLPADDING="0"
 851 CELLSPACING="0"
 852 ><TR
 853 ><TD
 854 WIDTH="33%"
 855 ALIGN="left"
 856 VALIGN="top"
 857 ><A
 858 HREF="quickstart.html"
 859 ACCESSKEY="P"
 860 >Prev</A
 861 ></TD
 862 ><TD
 863 WIDTH="34%"
 864 ALIGN="center"
 865 VALIGN="top"
 866 ><A
 867 HREF="index.html"
 868 ACCESSKEY="H"
 869 >Home</A
 870 ></TD
 871 ><TD
 872 WIDTH="33%"
 873 ALIGN="right"
 874 VALIGN="top"
 875 ><A
 876 HREF="configuration.html"
 877 ACCESSKEY="N"
 878 >Next</A
 879 ></TD
 880 ></TR
 881 ><TR
 882 ><TD
 883 WIDTH="33%"
 884 ALIGN="left"
 885 VALIGN="top"
 886 >Quickstart to Using Privoxy</TD
 887 ><TD
 888 WIDTH="34%"
 889 ALIGN="center"
 890 VALIGN="top"
 891 >&nbsp;</TD
 892 ><TD
 893 WIDTH="33%"
 894 ALIGN="right"
 895 VALIGN="top"
 896 >Privoxy Configuration</TD
 897 ></TR
 898 ></TABLE
 899 ></DIV
 900 ></BODY
 901 ></HTML
 902 >