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