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