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.6 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.6 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.6-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. </P
 156 ><P
 157 > If you have problems with failed dependencies, try rebuilding the SRC RPM:
 158  <TT
 159 CLASS="LITERAL"
 160 >rpm --rebuild privoxy-3.0.6-1.src.rpm</TT
 161 >. This
 162  will use your locally installed libraries and RPM version. </P
 163 ><P
 164 > Also note that if you have a <SPAN
 165 CLASS="APPLICATION"
 166 >Junkbuster</SPAN
 167 > RPM installed
 168  on your system, you need to remove it first, because the packages conflict.
 169  Otherwise, RPM will try to remove <SPAN
 170 CLASS="APPLICATION"
 171 >Junkbuster</SPAN
 172 >
 173  automatically if found, before installing <SPAN
 174 CLASS="APPLICATION"
 175 >Privoxy</SPAN
 176 >.</P
 177 ></DIV
 178 ><DIV
 179 CLASS="SECT3"
 180 ><H3
 181 CLASS="SECT3"
 182 ><A
 183 NAME="INSTALLATION-DEB"
 184 ></A
 185 >2.1.2. Debian</H3
 186 ><P
 187 > DEBs can be installed with <TT
 188 CLASS="LITERAL"
 189 >apt-get install privoxy</TT
 190 >,
 191  and will use <TT
 192 CLASS="FILENAME"
 193 >/etc/privoxy</TT
 194 > for the location of
 195  configuration files.</P
 196 ></DIV
 197 ><DIV
 198 CLASS="SECT3"
 199 ><H3
 200 CLASS="SECT3"
 201 ><A
 202 NAME="INSTALLATION-PACK-WIN"
 203 ></A
 204 >2.1.3. Windows</H3
 205 ><P
 206 > Just double-click the installer, which will guide you through
 207  the installation process. You will find the configuration files
 208  in the same directory as you installed <SPAN
 209 CLASS="APPLICATION"
 210 >Privoxy</SPAN
 211 > in. </P
 212 ><P
 213 > Version 3.0.4 introduced full <SPAN
 214 CLASS="APPLICATION"
 215 >Windows</SPAN
 216 > service
 217  functionality. On Windows only, the <SPAN
 218 CLASS="APPLICATION"
 219 >Privoxy</SPAN
 220 >
 221  program has two new command line arguments to install and uninstall
 222  <SPAN
 223 CLASS="APPLICATION"
 224 >Privoxy</SPAN
 225 > as a <SPAN
 226 CLASS="emphasis"
 227 ><I
 228 CLASS="EMPHASIS"
 229 >service</I
 230 ></SPAN
 231 >.</P
 232 ><P
 233 ></P
 234 ><DIV
 235 CLASS="VARIABLELIST"
 236 ><DL
 237 ><DT
 238 >Arguments:</DT
 239 ><DD
 240 ><P
 241 >     <TT
 242 CLASS="REPLACEABLE"
 243 ><I
 244 >--install</I
 245 ></TT
 246 >[:<TT
 247 CLASS="REPLACEABLE"
 248 ><I
 249 >service_name</I
 250 ></TT
 251 >]
 252     </P
 253 ><P
 254 >     <TT
 255 CLASS="REPLACEABLE"
 256 ><I
 257 >--uninstall</I
 258 ></TT
 259 >[:<TT
 260 CLASS="REPLACEABLE"
 261 ><I
 262 >service_name</I
 263 ></TT
 264 >]
 265     </P
 266 ></DD
 267 ></DL
 268 ></DIV
 269 ><P
 270 > After invoking <SPAN
 271 CLASS="APPLICATION"
 272 >Privoxy</SPAN
 273 > with
 274  <B
 275 CLASS="COMMAND"
 276 >--install</B
 277 >, you will need to bring up the
 278  <SPAN
 279 CLASS="APPLICATION"
 280 >Windows</SPAN
 281 > service console to assign the user you
 282  want <SPAN
 283 CLASS="APPLICATION"
 284 >Privoxy</SPAN
 285 > to run under, and whether or not you
 286  want it to run whenever the system starts. You can start the
 287  <SPAN
 288 CLASS="APPLICATION"
 289 >Windows</SPAN
 290 > services console with the following
 291  command: <B
 292 CLASS="COMMAND"
 293 >services.msc</B
 294 >.  If you do not take the manual step
 295  of modifying <SPAN
 296 CLASS="APPLICATION"
 297 >Privoxy's</SPAN
 298 > service settings, it will
 299  not start.  Note too that you will need to give Privoxy a user account that
 300  actually exists, or it will not be permitted to
 301  write to its log and configuration files.</P
 302 ></DIV
 303 ><DIV
 304 CLASS="SECT3"
 305 ><H3
 306 CLASS="SECT3"
 307 ><A
 308 NAME="INSTALLATION-PACK-BINTGZ"
 309 ></A
 310 >2.1.4. Solaris, NetBSD, FreeBSD, HP-UX</H3
 311 ><P
 312 > Create a new directory, <TT
 313 CLASS="LITERAL"
 314 >cd</TT
 315 > to it, then unzip and
 316  untar the archive. For the most part, you'll have to figure out where
 317  things go. </P
 318 ></DIV
 319 ><DIV
 320 CLASS="SECT3"
 321 ><H3
 322 CLASS="SECT3"
 323 ><A
 324 NAME="INSTALLATION-OS2"
 325 ></A
 326 >2.1.5. OS/2</H3
 327 ><P
 328 > First, make sure that no previous installations of
 329  <SPAN
 330 CLASS="APPLICATION"
 331 >Junkbuster</SPAN
 332 > and / or
 333  <SPAN
 334 CLASS="APPLICATION"
 335 >Privoxy</SPAN
 336 > are left on your
 337  system. Check that no <SPAN
 338 CLASS="APPLICATION"
 339 >Junkbuster</SPAN
 340 >
 341  or <SPAN
 342 CLASS="APPLICATION"
 343 >Privoxy</SPAN
 344 > objects are in
 345  your startup folder.&#13;</P
 346 ><P
 347 > Then, just double-click the WarpIN self-installing archive, which will
 348  guide you through the installation process. A shadow of the
 349  <SPAN
 350 CLASS="APPLICATION"
 351 >Privoxy</SPAN
 352 > executable will be placed in your
 353  startup folder so it will start automatically whenever OS/2 starts.</P
 354 ><P
 355 > The directory you choose to install <SPAN
 356 CLASS="APPLICATION"
 357 >Privoxy</SPAN
 358 >
 359  into will contain all of the configuration files.</P
 360 ></DIV
 361 ><DIV
 362 CLASS="SECT3"
 363 ><H3
 364 CLASS="SECT3"
 365 ><A
 366 NAME="INSTALLATION-MAC"
 367 ></A
 368 >2.1.6. Mac OSX</H3
 369 ><P
 370 > Unzip the downloaded file (you can either double-click on the file
 371  from the finder, or from the desktop if you downloaded it there).
 372  Then, double-click on the package installer icon named
 373  <TT
 374 CLASS="LITERAL"
 375 >Privoxy.pkg</TT
 376 >
 377  and follow the installation process.
 378  <SPAN
 379 CLASS="APPLICATION"
 380 >Privoxy</SPAN
 381 > will be installed in the folder
 382  <TT
 383 CLASS="LITERAL"
 384 >/Library/Privoxy</TT
 385 >.
 386  It will start automatically whenever you start up.  To prevent it from
 387  starting automatically, remove or rename the folder
 388  <TT
 389 CLASS="LITERAL"
 390 >/Library/StartupItems/Privoxy</TT
 391 >. </P
 392 ><P
 393 > To start Privoxy by hand, double-click on
 394  <TT
 395 CLASS="LITERAL"
 396 >StartPrivoxy.command</TT
 397 > in the
 398  <TT
 399 CLASS="LITERAL"
 400 >/Library/Privoxy</TT
 401 > folder.
 402  Or, type this command in the Terminal:</P
 403 ><P
 404 >  <TABLE
 405 BORDER="0"
 406 BGCOLOR="#E0E0E0"
 407 WIDTH="100%"
 408 ><TR
 409 ><TD
 410 ><PRE
 411 CLASS="SCREEN"
 412 >  /Library/Privoxy/StartPrivoxy.command
 413   </PRE
 414 ></TD
 415 ></TR
 416 ></TABLE
 417 ></P
 418 ><P
 419 > You will be prompted for the administrator password.</P
 420 ></DIV
 421 ><DIV
 422 CLASS="SECT3"
 423 ><H3
 424 CLASS="SECT3"
 425 ><A
 426 NAME="INSTALLATION-AMIGA"
 427 ></A
 428 >2.1.7. AmigaOS</H3
 429 ><P
 430 > Copy and then unpack the <TT
 431 CLASS="FILENAME"
 432 >lha</TT
 433 > archive to a suitable location.
 434  All necessary files will be installed into <SPAN
 435 CLASS="APPLICATION"
 436 >Privoxy</SPAN
 437 >
 438  directory, including all configuration and log files. To uninstall, just
 439  remove this directory.</P
 440 ></DIV
 441 ><DIV
 442 CLASS="SECT3"
 443 ><H3
 444 CLASS="SECT3"
 445 ><A
 446 NAME="INSTALLATTION-GENTOO"
 447 ></A
 448 >2.1.8. Gentoo</H3
 449 ><P
 450 > Gentoo source packages (Ebuilds) for <SPAN
 451 CLASS="APPLICATION"
 452 >Privoxy</SPAN
 453 > are
 454  contained in the Gentoo  Portage Tree (they are not on the download page,
 455  but there is a Gentoo section, where you can see when a new
 456  <SPAN
 457 CLASS="APPLICATION"
 458 >Privoxy</SPAN
 459 > Version is added to the  Portage Tree).</P
 460 ><P
 461 > Before installing <SPAN
 462 CLASS="APPLICATION"
 463 >Privoxy</SPAN
 464 > under Gentoo just do
 465  first <TT
 466 CLASS="LITERAL"
 467 >emerge rsync</TT
 468 > to get the latest changes from the
 469  Portage tree. With <TT
 470 CLASS="LITERAL"
 471 >emerge privoxy</TT
 472 > you install the latest
 473  version.</P
 474 ><P
 475 > Configuration files are in <TT
 476 CLASS="FILENAME"
 477 >/etc/privoxy</TT
 478 >, the
 479  documentation is in <TT
 480 CLASS="FILENAME"
 481 >/usr/share/doc/privoxy-3.0.6</TT
 482 >
 483  and the Log directory is in <TT
 484 CLASS="FILENAME"
 485 >/var/log/privoxy</TT
 486 >.</P
 487 ></DIV
 488 ></DIV
 489 ><DIV
 490 CLASS="SECT2"
 491 ><H2
 492 CLASS="SECT2"
 493 ><A
 494 NAME="INSTALLATION-SOURCE"
 495 ></A
 496 >2.2. Building from Source</H2
 497 ><P
 498 > The most convenient way to obtain the <SPAN
 499 CLASS="APPLICATION"
 500 >Privoxy</SPAN
 501 > sources
 502  is to download the source tarball from our <A
 503 HREF="http://sf.net/projects/ijbswa/"
 504 TARGET="_top"
 505 >project
 506  page</A
 507 >.</P
 508 ><P
 509 > If you like to live on the bleeding edge and are not afraid of using
 510  possibly unstable development versions, you can check out the up-to-the-minute
 511  version directly from <A
 512 HREF="http://sourceforge.net/cvs/?group_id=11118"
 513 TARGET="_top"
 514 >the
 515  CVS repository</A
 516 >. </P
 517 ><P
 518 > To build <SPAN
 519 CLASS="APPLICATION"
 520 >Privoxy</SPAN
 521 > from source,
 522  <A
 523 HREF="http://www.gnu.org/software/autoconf/autoconf.html"
 524 TARGET="_top"
 525 >autoconf</A
 526 >,
 527  <A
 528 HREF="http://www.gnu.org/software/make/make.html"
 529 TARGET="_top"
 530 >GNU make
 531  (gmake)</A
 532 >, and, of course, a C compiler like <A
 533 HREF="http://www.gnu.org/software/gcc/gcc.html"
 534 TARGET="_top"
 535 >gcc</A
 536 > are required.</P
 537 ><P
 538 > When building from a source tarball,
 539  first unpack the source: </P
 540 ><P
 541 > <TABLE
 542 BORDER="0"
 543 BGCOLOR="#E0E0E0"
 544 WIDTH="100%"
 545 ><TR
 546 ><TD
 547 ><PRE
 548 CLASS="SCREEN"
 549 > tar xzvf privoxy-3.0.6-beta-src* [.tgz or .tar.gz]
 550  cd privoxy-3.0.6-beta</PRE
 551 ></TD
 552 ></TR
 553 ></TABLE
 554 ></P
 555 ><P
 556 > For retrieving the current CVS sources, you'll need a CVS client installed.
 557  Note that sources from CVS are typicially development quality, and may not be
 558  stable, or well tested. To download CVS source, check the Sourceforge
 559  documentation, which might give commands like:</P
 560 ><P
 561 > <TABLE
 562 BORDER="0"
 563 BGCOLOR="#E0E0E0"
 564 WIDTH="100%"
 565 ><TR
 566 ><TD
 567 ><PRE
 568 CLASS="SCREEN"
 569 >  cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login
 570   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current
 571   cd current</PRE
 572 ></TD
 573 ></TR
 574 ></TABLE
 575 ></P
 576 ><P
 577 > This will create a directory named <TT
 578 CLASS="FILENAME"
 579 >current/</TT
 580 >, which will
 581  contain the source tree.</P
 582 ><P
 583 > You can also check out any <SPAN
 584 CLASS="APPLICATION"
 585 >Privoxy</SPAN
 586 >
 587  <SPAN
 588 CLASS="QUOTE"
 589 >"branch"</SPAN
 590 >, just exchange the <SPAN
 591 CLASS="APPLICATION"
 592 >current</SPAN
 593 >
 594  name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs
 595  tree).</P
 596 ><P
 597 > It is also strongly recommended to not run <SPAN
 598 CLASS="APPLICATION"
 599 >Privoxy</SPAN
 600 >
 601  as root, and instead it is suggested to create a <SPAN
 602 CLASS="QUOTE"
 603 >"privoxy"</SPAN
 604 > user
 605  and group for this purpose. See your local documentation for the correct
 606  command line to do this. </P
 607 ><P
 608 > <TT
 609 CLASS="FILENAME"
 610 >/etc/passwd</TT
 611 > might then look like:</P
 612 ><P
 613 > <TABLE
 614 BORDER="0"
 615 BGCOLOR="#E0E0E0"
 616 WIDTH="100%"
 617 ><TR
 618 ><TD
 619 ><PRE
 620 CLASS="SCREEN"
 621 >  privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE
 622 ></TD
 623 ></TR
 624 ></TABLE
 625 ></P
 626 ><P
 627 > And then <TT
 628 CLASS="FILENAME"
 629 >/etc/group</TT
 630 >, like:</P
 631 ><P
 632 > <TABLE
 633 BORDER="0"
 634 BGCOLOR="#E0E0E0"
 635 WIDTH="100%"
 636 ><TR
 637 ><TD
 638 ><PRE
 639 CLASS="SCREEN"
 640 >  privoxy:*:7777:</PRE
 641 ></TD
 642 ></TR
 643 ></TABLE
 644 ></P
 645 ><P
 646 > Some binary packages may do this for you.</P
 647 ><P
 648 > Then, to build from either unpacked tarball or CVS source:</P
 649 ><P
 650 > <TABLE
 651 BORDER="0"
 652 BGCOLOR="#E0E0E0"
 653 WIDTH="100%"
 654 ><TR
 655 ><TD
 656 ><PRE
 657 CLASS="SCREEN"
 658 > autoheader
 659  autoconf
 660  ./configure      # (--help to see options)
 661  make             # (the make from GNU, sometimes called gmake)
 662  su
 663  make -n install  # (to see where all the files will go)
 664  make -s install  # (to really install, -s to silence output)</PRE
 665 ></TD
 666 ></TR
 667 ></TABLE
 668 ></P
 669 ><P
 670 >  If you have GNU <B
 671 CLASS="COMMAND"
 672 >make</B
 673 >, you can have the first four steps
 674   automatically done for you by just typing:</P
 675 ><P
 676 > <TABLE
 677 BORDER="0"
 678 BGCOLOR="#E0E0E0"
 679 WIDTH="100%"
 680 ><TR
 681 ><TD
 682 ><PRE
 683 CLASS="SCREEN"
 684 >  make</PRE
 685 ></TD
 686 ></TR
 687 ></TABLE
 688 ></P
 689 ><P
 690 >  in the freshly downloaded or unpacked source directory.</P
 691 ><P
 692 > <SPAN
 693 CLASS="emphasis"
 694 ><I
 695 CLASS="EMPHASIS"
 696 >WARNING:</I
 697 ></SPAN
 698 > If installing as root, the install will fail
 699  unless a non-root user or group is specified, or a <TT
 700 CLASS="LITERAL"
 701 >privoxy</TT
 702 >
 703  user and group already exist on the system. If a non-root user is specified,
 704  and no group, then the installation will try to also use a group of the same name
 705  as <SPAN
 706 CLASS="QUOTE"
 707 >"user"</SPAN
 708 >. If a group is specified (and no user), then the
 709  support files will be installed as writable by that group, and owned by the
 710  user running the installation.</P
 711 ><P
 712 > <B
 713 CLASS="COMMAND"
 714 >configure</B
 715 > accepts <TT
 716 CLASS="LITERAL"
 717 >--with-user</TT
 718 > and
 719  <TT
 720 CLASS="LITERAL"
 721 >--with-group</TT
 722 > options for setting user and group ownership
 723  of the configuration files (which need to be writable by the daemon). The
 724  specified <SPAN
 725 CLASS="emphasis"
 726 ><I
 727 CLASS="EMPHASIS"
 728 >user must already exist</I
 729 ></SPAN
 730 >. When starting
 731  <SPAN
 732 CLASS="APPLICATION"
 733 >Privoxy</SPAN
 734 >, it should be run as this same user to
 735  insure write access to configuration and log files.</P
 736 ><P
 737 > Alternately, you can specify <TT
 738 CLASS="LITERAL"
 739 >user</TT
 740 > and <TT
 741 CLASS="LITERAL"
 742 >group</TT
 743 >
 744  on the <B
 745 CLASS="COMMAND"
 746 >make</B
 747 > command line, but be sure both already exist:</P
 748 ><P
 749 > <TABLE
 750 BORDER="0"
 751 BGCOLOR="#E0E0E0"
 752 WIDTH="100%"
 753 ><TR
 754 ><TD
 755 ><PRE
 756 CLASS="SCREEN"
 757 > make -s install  USER=privoxy GROUP=privoxy</PRE
 758 ></TD
 759 ></TR
 760 ></TABLE
 761 ></P
 762 ><P
 763 > The default installation path for <B
 764 CLASS="COMMAND"
 765 >make install</B
 766 > is
 767  <TT
 768 CLASS="FILENAME"
 769 >/usr/local</TT
 770 >. This may of course be customized with
 771  the various <B
 772 CLASS="COMMAND"
 773 >./configure</B
 774 > path options. If you are doing
 775  a root install to anywhere else besides <TT
 776 CLASS="FILENAME"
 777 >/usr/local</TT
 778 >, be
 779  sure to set the appropriate paths with the correct configure options
 780  (<B
 781 CLASS="COMMAND"
 782 >./configure --help</B
 783 >).</P
 784 ><P
 785 > If you do install to <TT
 786 CLASS="FILENAME"
 787 >/usr/local</TT
 788 >, the install will use
 789  <TT
 790 CLASS="LITERAL"
 791 >sysconfdir=$prefix/etc/privoxy</TT
 792 > by default. All other
 793  destinations, and the direct usage of <TT
 794 CLASS="LITERAL"
 795 >--sysconfdir</TT
 796 > flag
 797  behave like normal, i.e. will not add the extra <TT
 798 CLASS="FILENAME"
 799 >privoxy</TT
 800 >
 801  directory. This is for a safer install, as there may already exist another
 802  program that uses a file with the <SPAN
 803 CLASS="QUOTE"
 804 >"config"</SPAN
 805 > name, and thus makes
 806  <TT
 807 CLASS="FILENAME"
 808 >/usr/local/etc</TT
 809 > cleaner.</P
 810 ><P
 811 > If installing to <TT
 812 CLASS="FILENAME"
 813 >/usr/local</TT
 814 >, the docs will go by default
 815  to <TT
 816 CLASS="FILENAME"
 817 >$prefix/share/doc</TT
 818 >. But if this directory doesn't
 819  exist, it will then try <TT
 820 CLASS="FILENAME"
 821 >$prefix/doc</TT
 822 > and install there before
 823  creating a new <TT
 824 CLASS="FILENAME"
 825 >$prefix/share/doc</TT
 826 > just for
 827  <SPAN
 828 CLASS="APPLICATION"
 829 >Privoxy</SPAN
 830 >.</P
 831 ><P
 832 > Again, if the installs goes to <TT
 833 CLASS="FILENAME"
 834 >/usr/local</TT
 835 >, the
 836  <TT
 837 CLASS="LITERAL"
 838 >localstatedir</TT
 839 > (ie: <TT
 840 CLASS="FILENAME"
 841 >var/</TT
 842 >) will default
 843  to <TT
 844 CLASS="FILENAME"
 845 >/var</TT
 846 > instead of <TT
 847 CLASS="LITERAL"
 848 >$prefix/var</TT
 849 > so
 850  the logs will go to <TT
 851 CLASS="FILENAME"
 852 >/var/log/privoxy/</TT
 853 >, and the pid file
 854  will be created in <TT
 855 CLASS="FILENAME"
 856 >/var/run/privoxy.pid</TT
 857 >. </P
 858 ><P
 859 > <B
 860 CLASS="COMMAND"
 861 >make install</B
 862 > will attempt to set the correct values
 863  in <TT
 864 CLASS="FILENAME"
 865 >config</TT
 866 > (main configuration file). You may want
 867  to check this to make sure all values are correct. If appropriate,
 868  an init script will be installed, but it is up to the user to determine
 869  how and where to start <SPAN
 870 CLASS="APPLICATION"
 871 >Privoxy</SPAN
 872 >. The init
 873  script should be checked for correct paths and values, if anything other than
 874  a default install is done.</P
 875 ><P
 876 > If install finds previous versions of any local configuration files, these
 877  will not be overwritten, and the new ones will be installed with a
 878  <SPAN
 879 CLASS="QUOTE"
 880 >"new"</SPAN
 881 > extension. default.action, default.filter, and
 882  standard.action will be overwritten. You will then need to manually update
 883  the other installed configuration files as needed. All template files will be
 884  overwritten. If you have customized, local templates, you should save these
 885  first. If a previous version of <SPAN
 886 CLASS="APPLICATION"
 887 >Privoxy</SPAN
 888 > is
 889  already running, you will have to restart it manually.</P
 890 ><P
 891 > For more detailed instructions on how to build Redhat 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 >