doc/webserver/user-manual/installation.html

   1 <HTML
   2 ><HEAD
   3 ><TITLE
   4 >Installation</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="Introduction"
  14 HREF="introduction.html"><LINK
  15 REL="NEXT"
  16 TITLE="What's New in this Release"
  17 HREF="whatsnew.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.4 User Manual</TH
  43 ></TR
  44 ><TR
  45 ><TD
  46 WIDTH="10%"
  47 ALIGN="left"
  48 VALIGN="bottom"
  49 ><A
  50 HREF="introduction.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="whatsnew.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="INSTALLATION"
  79 ></A
  80 >2. Installation</H1
  81 ><P
  82 > <SPAN
  83 CLASS="APPLICATION"
  84 >Privoxy</SPAN
  85 > is available both in convenient pre-compiled
  86  packages for a wide range of operating systems, and as raw source code.
  87  For most users, we recommend using the packages, which can be downloaded from our
  88  <A
  89 HREF="http://sourceforge.net/projects/ijbswa/"
  90 TARGET="_top"
  91 >Privoxy Project
  92  Page</A
  93 >.</P
  94 ><P
  95 > Note:
  96  On some platforms, the installer may remove previously installed versions, if
  97  found. (See below for your platform). In any case <SPAN
  98 CLASS="emphasis"
  99 ><I
 100 CLASS="EMPHASIS"
 101 >be sure to backup
 102  your old configuration if it is valuable to you.</I
 103 ></SPAN
 104 > See the <A
 105 HREF="whatsnew.html#UPGRADERSNOTE"
 106 >note to upgraders</A
 107 > section below.</P
 108 ><DIV
 109 CLASS="SECT2"
 110 ><H2
 111 CLASS="SECT2"
 112 ><A
 113 NAME="INSTALLATION-PACKAGES"
 114 ></A
 115 >2.1. Binary Packages</H2
 116 ><P
 117 >How to install the binary packages depends on your operating system:</P
 118 ><DIV
 119 CLASS="SECT3"
 120 ><H3
 121 CLASS="SECT3"
 122 ><A
 123 NAME="INSTALLATION-PACK-RPM"
 124 ></A
 125 >2.1.1. Red Hat, SuSE and Conectiva RPMs</H3
 126 ><P
 127 > RPMs can be installed with <TT
 128 CLASS="LITERAL"
 129 >rpm -Uvh privoxy-3.0.4-1.rpm</TT
 130 >,
 131  and will use <TT
 132 CLASS="FILENAME"
 133 >/etc/privoxy</TT
 134 > for the location
 135  of configuration files.</P
 136 ><P
 137 > Note that on Red Hat, <SPAN
 138 CLASS="APPLICATION"
 139 >Privoxy</SPAN
 140 > will
 141  <SPAN
 142 CLASS="emphasis"
 143 ><I
 144 CLASS="EMPHASIS"
 145 >not</I
 146 ></SPAN
 147 > be automatically started on system boot. You will
 148  need to enable that using <B
 149 CLASS="COMMAND"
 150 >chkconfig</B
 151 >,
 152  <B
 153 CLASS="COMMAND"
 154 >ntsysv</B
 155 >, or similar methods. Note that SuSE will
 156 automatically start Privoxy in the boot process.</P
 157 ><P
 158 > If you have problems with failed dependencies, try rebuilding the SRC RPM:
 159  <TT
 160 CLASS="LITERAL"
 161 >rpm --rebuild privoxy-3.0.4-1.src.rpm</TT
 162 >. This
 163  will use your locally installed libraries and RPM version. </P
 164 ><P
 165 > Also note that if you have a <SPAN
 166 CLASS="APPLICATION"
 167 >Junkbuster</SPAN
 168 > RPM installed
 169  on your system, you need to remove it first, because the packages conflict.
 170  Otherwise, RPM will try to remove <SPAN
 171 CLASS="APPLICATION"
 172 >Junkbuster</SPAN
 173 >
 174  automatically if found, before installing <SPAN
 175 CLASS="APPLICATION"
 176 >Privoxy</SPAN
 177 >.</P
 178 ></DIV
 179 ><DIV
 180 CLASS="SECT3"
 181 ><H3
 182 CLASS="SECT3"
 183 ><A
 184 NAME="INSTALLATION-DEB"
 185 ></A
 186 >2.1.2. Debian</H3
 187 ><P
 188 > DEBs can be installed with <TT
 189 CLASS="LITERAL"
 190 >apt-get install privoxy</TT
 191 >,
 192  and will use <TT
 193 CLASS="FILENAME"
 194 >/etc/privoxy</TT
 195 > for the location of
 196  configuration files.</P
 197 ></DIV
 198 ><DIV
 199 CLASS="SECT3"
 200 ><H3
 201 CLASS="SECT3"
 202 ><A
 203 NAME="INSTALLATION-PACK-WIN"
 204 ></A
 205 >2.1.3. Windows</H3
 206 ><P
 207 > Just double-click the installer, which will guide you through
 208  the installation process. You will find the configuration files
 209  in the same directory as you installed <SPAN
 210 CLASS="APPLICATION"
 211 >Privoxy</SPAN
 212 > in. </P
 213 ><P
 214 > Version 3.0.4 introduces full <SPAN
 215 CLASS="APPLICATION"
 216 >Windows</SPAN
 217 > service
 218  functionality. On Windows only, the <SPAN
 219 CLASS="APPLICATION"
 220 >Privoxy</SPAN
 221 >
 222  program has two new command line arguments to install and uninstall
 223  <SPAN
 224 CLASS="APPLICATION"
 225 >Privoxy</SPAN
 226 > as a <SPAN
 227 CLASS="emphasis"
 228 ><I
 229 CLASS="EMPHASIS"
 230 >service</I
 231 ></SPAN
 232 >.</P
 233 ><P
 234 ></P
 235 ><DIV
 236 CLASS="VARIABLELIST"
 237 ><DL
 238 ><DT
 239 >Arguments:</DT
 240 ><DD
 241 ><P
 242 >     <TT
 243 CLASS="REPLACEABLE"
 244 ><I
 245 >--install</I
 246 ></TT
 247 >[:<TT
 248 CLASS="REPLACEABLE"
 249 ><I
 250 >service_name</I
 251 ></TT
 252 >]
 253     </P
 254 ><P
 255 >     <TT
 256 CLASS="REPLACEABLE"
 257 ><I
 258 >--uninstall</I
 259 ></TT
 260 >[:<TT
 261 CLASS="REPLACEABLE"
 262 ><I
 263 >service_name</I
 264 ></TT
 265 >]
 266     </P
 267 ></DD
 268 ></DL
 269 ></DIV
 270 ><P
 271 > After invoking <SPAN
 272 CLASS="APPLICATION"
 273 >Privoxy</SPAN
 274 > with
 275  <B
 276 CLASS="COMMAND"
 277 >--install</B
 278 >, you will need to bring up the
 279  <SPAN
 280 CLASS="APPLICATION"
 281 >Windows</SPAN
 282 > service console to assign the user you
 283  want <SPAN
 284 CLASS="APPLICATION"
 285 >Privoxy</SPAN
 286 > to run under, and whether or not you
 287  want it to run whenever the system starts. You can start the
 288  <SPAN
 289 CLASS="APPLICATION"
 290 >Windows</SPAN
 291 > services console with the following
 292  command: <B
 293 CLASS="COMMAND"
 294 >services.msc</B
 295 >  If you do not take the manual step
 296  of modifying <SPAN
 297 CLASS="APPLICATION"
 298 >Privoxy's</SPAN
 299 > service settings, it will
 300  not start.  Note too that you will need to give Privoxy a user account that
 301  actually exists, or it will not be permitted to
 302  write to its log and configuration files.</P
 303 ></DIV
 304 ><DIV
 305 CLASS="SECT3"
 306 ><H3
 307 CLASS="SECT3"
 308 ><A
 309 NAME="INSTALLATION-PACK-BINTGZ"
 310 ></A
 311 >2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</H3
 312 ><P
 313 > Create a new directory, <TT
 314 CLASS="LITERAL"
 315 >cd</TT
 316 > to it, then unzip and
 317  untar the archive. For the most part, you'll have to figure out where
 318  things go. </P
 319 ></DIV
 320 ><DIV
 321 CLASS="SECT3"
 322 ><H3
 323 CLASS="SECT3"
 324 ><A
 325 NAME="INSTALLATION-OS2"
 326 ></A
 327 >2.1.5. OS/2</H3
 328 ><P
 329 > First, make sure that no previous installations of
 330  <SPAN
 331 CLASS="APPLICATION"
 332 >Junkbuster</SPAN
 333 > and / or
 334  <SPAN
 335 CLASS="APPLICATION"
 336 >Privoxy</SPAN
 337 > are left on your
 338  system. Check that no <SPAN
 339 CLASS="APPLICATION"
 340 >Junkbuster</SPAN
 341 >
 342  or <SPAN
 343 CLASS="APPLICATION"
 344 >Privoxy</SPAN
 345 > objects are in
 346  your startup folder.&#13;</P
 347 ><P
 348 > Then, just double-click the WarpIN self-installing archive, which will
 349  guide you through the installation process. A shadow of the
 350  <SPAN
 351 CLASS="APPLICATION"
 352 >Privoxy</SPAN
 353 > executable will be placed in your
 354  startup folder so it will start automatically whenever OS/2 starts.</P
 355 ><P
 356 > The directory you choose to install <SPAN
 357 CLASS="APPLICATION"
 358 >Privoxy</SPAN
 359 >
 360  into will contain all of the configuration files.</P
 361 ></DIV
 362 ><DIV
 363 CLASS="SECT3"
 364 ><H3
 365 CLASS="SECT3"
 366 ><A
 367 NAME="INSTALLATION-MAC"
 368 ></A
 369 >2.1.6. Mac OSX</H3
 370 ><P
 371 > Unzip the downloaded file (you can either double-click on the file
 372  from the finder, or from the desktop if you downloaded it there).
 373  Then, double-click on the package installer icon named
 374  <TT
 375 CLASS="LITERAL"
 376 >Privoxy.pkg</TT
 377 >
 378  and follow the installation process.
 379  <SPAN
 380 CLASS="APPLICATION"
 381 >Privoxy</SPAN
 382 > will be installed in the folder
 383  <TT
 384 CLASS="LITERAL"
 385 >/Library/Privoxy</TT
 386 >.
 387  It will start automatically whenever you start up.  To prevent it from
 388  starting automatically, remove or rename the folder
 389  <TT
 390 CLASS="LITERAL"
 391 >/Library/StartupItems/Privoxy</TT
 392 >. </P
 393 ><P
 394 > To start Privoxy by hand, double-click on
 395  <TT
 396 CLASS="LITERAL"
 397 >StartPrivoxy.command</TT
 398 > in the
 399  <TT
 400 CLASS="LITERAL"
 401 >/Library/Privoxy</TT
 402 > folder.
 403  Or, type this command in the Terminal:</P
 404 ><P
 405 >  <TABLE
 406 BORDER="0"
 407 BGCOLOR="#E0E0E0"
 408 WIDTH="100%"
 409 ><TR
 410 ><TD
 411 ><PRE
 412 CLASS="SCREEN"
 413 >  /Library/Privoxy/StartPrivoxy.command
 414   </PRE
 415 ></TD
 416 ></TR
 417 ></TABLE
 418 ></P
 419 ><P
 420 > You will be prompted for the administrator password.</P
 421 ></DIV
 422 ><DIV
 423 CLASS="SECT3"
 424 ><H3
 425 CLASS="SECT3"
 426 ><A
 427 NAME="INSTALLATION-AMIGA"
 428 ></A
 429 >2.1.7. AmigaOS</H3
 430 ><P
 431 > Copy and then unpack the <TT
 432 CLASS="FILENAME"
 433 >lha</TT
 434 > archive to a suitable location.
 435  All necessary files will be installed into <SPAN
 436 CLASS="APPLICATION"
 437 >Privoxy</SPAN
 438 >
 439  directory, including all configuration and log files. To uninstall, just
 440  remove this directory.</P
 441 ></DIV
 442 ><DIV
 443 CLASS="SECT3"
 444 ><H3
 445 CLASS="SECT3"
 446 ><A
 447 NAME="INSTALLATTION-GENTOO"
 448 ></A
 449 >2.1.8. Gentoo</H3
 450 ><P
 451 > Gentoo source packages (Ebuilds) for <SPAN
 452 CLASS="APPLICATION"
 453 >Privoxy</SPAN
 454 > are
 455  contained in the Gentoo  Portage Tree (they are not on the download page,
 456  but there is a Gentoo section, where you can see when a new
 457  <SPAN
 458 CLASS="APPLICATION"
 459 >Privoxy</SPAN
 460 > Version is added to the  Portage Tree).</P
 461 ><P
 462 > Before installing <SPAN
 463 CLASS="APPLICATION"
 464 >Privoxy</SPAN
 465 > under Gentoo just do
 466  first <TT
 467 CLASS="LITERAL"
 468 >emerge rsync</TT
 469 > to get the latest changes from the
 470  Portage tree. With <TT
 471 CLASS="LITERAL"
 472 >emerge privoxy</TT
 473 > you install the latest
 474  version.</P
 475 ><P
 476 > Configuration files are in <TT
 477 CLASS="FILENAME"
 478 >/etc/privoxy</TT
 479 >, the
 480  documentation is in <TT
 481 CLASS="FILENAME"
 482 >/usr/share/doc/privoxy-3.0.4</TT
 483 >
 484  and the Log directory is in <TT
 485 CLASS="FILENAME"
 486 >/var/log/privoxy</TT
 487 >.</P
 488 ></DIV
 489 ></DIV
 490 ><DIV
 491 CLASS="SECT2"
 492 ><H2
 493 CLASS="SECT2"
 494 ><A
 495 NAME="INSTALLATION-SOURCE"
 496 ></A
 497 >2.2. Building from Source</H2
 498 ><P
 499 > The most convenient way to obtain the <SPAN
 500 CLASS="APPLICATION"
 501 >Privoxy</SPAN
 502 > sources
 503  is to download the source tarball from our <A
 504 HREF="http://sf.net/projects/ijbswa/"
 505 TARGET="_top"
 506 >project
 507  page</A
 508 >.</P
 509 ><P
 510 > If you like to live on the bleeding edge and are not afraid of using
 511  possibly unstable development versions, you can check out the up-to-the-minute
 512  version directly from <A
 513 HREF="http://sourceforge.net/cvs/?group_id=11118"
 514 TARGET="_top"
 515 >the
 516  CVS repository</A
 517 >. </P
 518 ><P
 519 > To build <SPAN
 520 CLASS="APPLICATION"
 521 >Privoxy</SPAN
 522 > from source,
 523  <A
 524 HREF="http://www.gnu.org/software/autoconf/autoconf.html"
 525 TARGET="_top"
 526 >autoconf</A
 527 >,
 528  <A
 529 HREF="http://www.gnu.org/software/make/make.html"
 530 TARGET="_top"
 531 >GNU make
 532  (gmake)</A
 533 >, and, of course, a C compiler like <A
 534 HREF="http://www.gnu.org/software/gcc/gcc.html"
 535 TARGET="_top"
 536 >gcc</A
 537 > are required.</P
 538 ><P
 539 > When building from a source tarball,
 540  first unpack the source: </P
 541 ><P
 542 > <TABLE
 543 BORDER="0"
 544 BGCOLOR="#E0E0E0"
 545 WIDTH="100%"
 546 ><TR
 547 ><TD
 548 ><PRE
 549 CLASS="SCREEN"
 550 > tar xzvf privoxy-3.0.4-beta-src* [.tgz or .tar.gz]
 551  cd privoxy-3.0.4-beta</PRE
 552 ></TD
 553 ></TR
 554 ></TABLE
 555 ></P
 556 ><P
 557 > For retrieving the current CVS sources, you'll need CVS installed.
 558  Note that sources from CVS are development quality, and may not be
 559  stable, or well tested. To download CVS source, check the Sourceforge
 560  documentation, which might give commands like:</P
 561 ><P
 562 > <TABLE
 563 BORDER="0"
 564 BGCOLOR="#E0E0E0"
 565 WIDTH="100%"
 566 ><TR
 567 ><TD
 568 ><PRE
 569 CLASS="SCREEN"
 570 >  cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login
 571   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current
 572   cd current</PRE
 573 ></TD
 574 ></TR
 575 ></TABLE
 576 ></P
 577 ><P
 578 > This will create a directory named <TT
 579 CLASS="FILENAME"
 580 >current/</TT
 581 >, which will
 582  contain the source tree.</P
 583 ><P
 584 > You can also check out any <SPAN
 585 CLASS="APPLICATION"
 586 >Privoxy</SPAN
 587 >
 588  <SPAN
 589 CLASS="QUOTE"
 590 >"branch"</SPAN
 591 >, just exchange the <SPAN
 592 CLASS="APPLICATION"
 593 >current</SPAN
 594 >
 595  name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs
 596  tree).</P
 597 ><P
 598 > It is also strongly recommended to not run <SPAN
 599 CLASS="APPLICATION"
 600 >Privoxy</SPAN
 601 >
 602  as root, and instead it is suggested to create a <SPAN
 603 CLASS="QUOTE"
 604 >"privoxy"</SPAN
 605 > user
 606  and group for this purpose. See your local documentation for the correct
 607  command line to do this. </P
 608 ><P
 609 > <TT
 610 CLASS="FILENAME"
 611 >/etc/passwd</TT
 612 > might then look like:</P
 613 ><P
 614 > <TABLE
 615 BORDER="0"
 616 BGCOLOR="#E0E0E0"
 617 WIDTH="100%"
 618 ><TR
 619 ><TD
 620 ><PRE
 621 CLASS="SCREEN"
 622 >  privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE
 623 ></TD
 624 ></TR
 625 ></TABLE
 626 ></P
 627 ><P
 628 > And then <TT
 629 CLASS="FILENAME"
 630 >/etc/group</TT
 631 >, like:</P
 632 ><P
 633 > <TABLE
 634 BORDER="0"
 635 BGCOLOR="#E0E0E0"
 636 WIDTH="100%"
 637 ><TR
 638 ><TD
 639 ><PRE
 640 CLASS="SCREEN"
 641 >  privoxy:*:7777:</PRE
 642 ></TD
 643 ></TR
 644 ></TABLE
 645 ></P
 646 ><P
 647 > Some binary packages may do this for you.</P
 648 ><P
 649 > Then, to build from either unpacked tarball or CVS source:</P
 650 ><P
 651 > <TABLE
 652 BORDER="0"
 653 BGCOLOR="#E0E0E0"
 654 WIDTH="100%"
 655 ><TR
 656 ><TD
 657 ><PRE
 658 CLASS="SCREEN"
 659 > autoheader
 660  autoconf
 661  ./configure      # (--help to see options)
 662  make             # (the make from GNU, sometimes called gmake)
 663  su
 664  make -n install  # (to see where all the files will go)
 665  make -s install  # (to really install, -s to silence output)</PRE
 666 ></TD
 667 ></TR
 668 ></TABLE
 669 ></P
 670 ><P
 671 >  If you have GNU <B
 672 CLASS="COMMAND"
 673 >make</B
 674 >, you can have the first four steps
 675   automatically done for you by just typing:</P
 676 ><P
 677 > <TABLE
 678 BORDER="0"
 679 BGCOLOR="#E0E0E0"
 680 WIDTH="100%"
 681 ><TR
 682 ><TD
 683 ><PRE
 684 CLASS="SCREEN"
 685 >  make</PRE
 686 ></TD
 687 ></TR
 688 ></TABLE
 689 ></P
 690 ><P
 691 >  in the freshly downloaded or unpacked source directory.</P
 692 ><P
 693 > <SPAN
 694 CLASS="emphasis"
 695 ><I
 696 CLASS="EMPHASIS"
 697 >WARNING:</I
 698 ></SPAN
 699 > If installing as root, the install will fail
 700  unless a non-root user or group is specified, or a <TT
 701 CLASS="LITERAL"
 702 >privoxy</TT
 703 >
 704  user and group already exist on the system. If a non-root user is specified,
 705  and no group, then the installation will try to also use a group of the same name
 706  as <SPAN
 707 CLASS="QUOTE"
 708 >"user"</SPAN
 709 >. If a group is specified (and no user), then the
 710  support files will be installed as writable by that group, and owned by the
 711  user running the installation.</P
 712 ><P
 713 > <B
 714 CLASS="COMMAND"
 715 >configure</B
 716 > accepts <TT
 717 CLASS="LITERAL"
 718 >--with-user</TT
 719 > and
 720  <TT
 721 CLASS="LITERAL"
 722 >--with-group</TT
 723 > options for setting user and group ownership
 724  of the configuration files (which need to be writable by the daemon). The
 725  specified <SPAN
 726 CLASS="emphasis"
 727 ><I
 728 CLASS="EMPHASIS"
 729 >user must already exist</I
 730 ></SPAN
 731 >. When starting
 732  <SPAN
 733 CLASS="APPLICATION"
 734 >Privoxy</SPAN
 735 >, it should be run as this same user to
 736  insure write access to configuration and log files.</P
 737 ><P
 738 > Alternately, you can specify <TT
 739 CLASS="LITERAL"
 740 >user</TT
 741 > and <TT
 742 CLASS="LITERAL"
 743 >group</TT
 744 >
 745  on the <B
 746 CLASS="COMMAND"
 747 >make</B
 748 > command line, but be sure both already exist:</P
 749 ><P
 750 > <TABLE
 751 BORDER="0"
 752 BGCOLOR="#E0E0E0"
 753 WIDTH="100%"
 754 ><TR
 755 ><TD
 756 ><PRE
 757 CLASS="SCREEN"
 758 > make -s install  USER=privoxy GROUP=privoxy</PRE
 759 ></TD
 760 ></TR
 761 ></TABLE
 762 ></P
 763 ><P
 764 > The default installation path for <B
 765 CLASS="COMMAND"
 766 >make install</B
 767 > is
 768  <TT
 769 CLASS="FILENAME"
 770 >/usr/local</TT
 771 >. This may of course be customized with
 772  the various <B
 773 CLASS="COMMAND"
 774 >./configure</B
 775 > path options. If you are doing
 776  a root install to anywhere else besides <TT
 777 CLASS="FILENAME"
 778 >/usr/local</TT
 779 >, be
 780  sure to set the appropriate paths with the correct configure options
 781  (<B
 782 CLASS="COMMAND"
 783 >./configure --help</B
 784 >).</P
 785 ><P
 786 > If you do install to <TT
 787 CLASS="FILENAME"
 788 >/usr/local</TT
 789 >, the install will use
 790  <TT
 791 CLASS="LITERAL"
 792 >sysconfdir=$prefix/etc/privoxy</TT
 793 > by default. All other
 794  destinations, and the direct usage of <TT
 795 CLASS="LITERAL"
 796 >--sysconfdir</TT
 797 > flag
 798  behave like normal, i.e. will not add the extra <TT
 799 CLASS="FILENAME"
 800 >privoxy</TT
 801 >
 802  directory. This is for a safer install, as there may already exist another
 803  program that uses a file with the <SPAN
 804 CLASS="QUOTE"
 805 >"config"</SPAN
 806 > name, and thus makes
 807  <TT
 808 CLASS="FILENAME"
 809 >/usr/local/etc</TT
 810 > cleaner.</P
 811 ><P
 812 > If installing to <TT
 813 CLASS="FILENAME"
 814 >/usr/local</TT
 815 >, the docs will go by default
 816  to <TT
 817 CLASS="FILENAME"
 818 >$prefix/share/doc</TT
 819 >. But if this directory doesn't
 820  exist, it will then try <TT
 821 CLASS="FILENAME"
 822 >$prefix/doc</TT
 823 > and install there before
 824  creating a new <TT
 825 CLASS="FILENAME"
 826 >$prefix/share/doc</TT
 827 > just for
 828  <SPAN
 829 CLASS="APPLICATION"
 830 >Privoxy</SPAN
 831 >.</P
 832 ><P
 833 > Again, if the installs goes to <TT
 834 CLASS="FILENAME"
 835 >/usr/local</TT
 836 >, the
 837  <TT
 838 CLASS="LITERAL"
 839 >localstatedir</TT
 840 > (ie: <TT
 841 CLASS="FILENAME"
 842 >var/</TT
 843 >) will default
 844  to <TT
 845 CLASS="FILENAME"
 846 >/var</TT
 847 > instead of <TT
 848 CLASS="LITERAL"
 849 >$prefix/var</TT
 850 > so
 851  the logs will go to <TT
 852 CLASS="FILENAME"
 853 >/var/log/privoxy/</TT
 854 >, and the pid file
 855  will be created in <TT
 856 CLASS="FILENAME"
 857 >/var/run/privoxy.pid</TT
 858 >. </P
 859 ><P
 860 > <B
 861 CLASS="COMMAND"
 862 >make install</B
 863 > will attempt to set the correct values
 864  in <TT
 865 CLASS="FILENAME"
 866 >config</TT
 867 > (main configuration file). You may want
 868  to check this to make sure all values are correct. If appropriate,
 869  an init script will be installed, but it is up to the user to determine
 870  how and where to start <SPAN
 871 CLASS="APPLICATION"
 872 >Privoxy</SPAN
 873 >. The init
 874  script should be checked for correct paths and values, if anything other than
 875  a default install is done.</P
 876 ><P
 877 > If install finds previous versions of any configuration files, these will not
 878  be overwritten, and the new ones will be installed with a <SPAN
 879 CLASS="QUOTE"
 880 >"new"</SPAN
 881 >
 882  extension. You will then need to manually update the installed configuration
 883  files as needed. All template files will be overwritten. If you have
 884  customized, local templates, you should save these first. If a previous
 885  version of <SPAN
 886 CLASS="APPLICATION"
 887 >Privoxy</SPAN
 888 > is already running, you will
 889  have to restart it manually.</P
 890 ><P
 891 > For more detailed instructions on how to build Redhat and SuSE RPMs,
 892  Windows self-extracting installers, building on platforms with
 893  special requirements etc, please consult the <A
 894 HREF="../developer-manual/newrelease.html"
 895 TARGET="_top"
 896 >developer manual</A
 897 >.</P
 898 ></DIV
 899 ><DIV
 900 CLASS="SECT2"
 901 ><H2
 902 CLASS="SECT2"
 903 ><A
 904 NAME="INSTALLATION-KEEPUPDATED"
 905 ></A
 906 >2.3. Keeping your Installation Up-to-Date</H2
 907 ><P
 908 > As user feedback comes in and development continues, we will make updated versions
 909  of both the main <A
 910 HREF="actions-file.html"
 911 >actions file</A
 912 > (as a <A
 913 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&release_id=103670"
 914 TARGET="_top"
 915 >separate
 916  package</A
 917 >) and the software itself (including the actions file) available for
 918  download.</P
 919 ><P
 920 > If you wish to receive an email notification whenever we release updates of
 921  <SPAN
 922 CLASS="APPLICATION"
 923 >Privoxy</SPAN
 924 > or the actions file, <A
 925 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 926 TARGET="_top"
 927 >subscribe
 928  to our announce  mailing list</A
 929 >, ijbswa-announce@lists.sourceforge.net.</P
 930 ><P
 931 > In order not to lose your personal changes and adjustments when updating
 932  to the latest <TT
 933 CLASS="LITERAL"
 934 >default.action</TT
 935 > file we <SPAN
 936 CLASS="emphasis"
 937 ><I
 938 CLASS="EMPHASIS"
 939 >strongly
 940  recommend</I
 941 ></SPAN
 942 > that you use <TT
 943 CLASS="LITERAL"
 944 >user.action</TT
 945 > and
 946  <TT
 947 CLASS="LITERAL"
 948 >user.filter</TT
 949 > for your local
 950  customizations of <SPAN
 951 CLASS="APPLICATION"
 952 >Privoxy</SPAN
 953 >. See the <A
 954 HREF="actions-file.html"
 955 >Chapter on actions files</A
 956 > for details.</P
 957 ></DIV
 958 ></DIV
 959 ><DIV
 960 CLASS="NAVFOOTER"
 961 ><HR
 962 ALIGN="LEFT"
 963 WIDTH="100%"><TABLE
 964 SUMMARY="Footer navigation table"
 965 WIDTH="100%"
 966 BORDER="0"
 967 CELLPADDING="0"
 968 CELLSPACING="0"
 969 ><TR
 970 ><TD
 971 WIDTH="33%"
 972 ALIGN="left"
 973 VALIGN="top"
 974 ><A
 975 HREF="introduction.html"
 976 ACCESSKEY="P"
 977 >Prev</A
 978 ></TD
 979 ><TD
 980 WIDTH="34%"
 981 ALIGN="center"
 982 VALIGN="top"
 983 ><A
 984 HREF="index.html"
 985 ACCESSKEY="H"
 986 >Home</A
 987 ></TD
 988 ><TD
 989 WIDTH="33%"
 990 ALIGN="right"
 991 VALIGN="top"
 992 ><A
 993 HREF="whatsnew.html"
 994 ACCESSKEY="N"
 995 >Next</A
 996 ></TD
 997 ></TR
 998 ><TR
 999 ><TD
1000 WIDTH="33%"
1001 ALIGN="left"
1002 VALIGN="top"
1003 >Introduction</TD
1004 ><TD
1005 WIDTH="34%"
1006 ALIGN="center"
1007 VALIGN="top"
1008 >&nbsp;</TD
1009 ><TD
1010 WIDTH="33%"
1011 ALIGN="right"
1012 VALIGN="top"
1013 >What's New in this Release</TD
1014 ></TR
1015 ></TABLE
1016 ></DIV
1017 ></BODY
1018 ></HTML
1019 >