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