doc/webserver/user-manual/startup.html

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