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 and Fedora 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
 503  <A
 504 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=10571"
 505 TARGET="_top"
 506 >project download
 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.6-src* [.tgz or .tar.gz]
 551  cd privoxy-3.0.6</PRE
 552 ></TD
 553 ></TR
 554 ></TABLE
 555 ></P
 556 ><P
 557 > For retrieving the current CVS sources, you'll need a CVS client installed.
 558  Note that sources from CVS are typically 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. You should configure/install/run <SPAN
 603 CLASS="APPLICATION"
 604 >Privoxy</SPAN
 605 > as
 606  an unprivileged user, preferably by  creating a <SPAN
 607 CLASS="QUOTE"
 608 >"privoxy"</SPAN
 609 > user
 610  and group just for this purpose. See your local documentation for the correct
 611  command line to do add new users and groups (something like
 612  <B
 613 CLASS="COMMAND"
 614 >adduser</B
 615 >, but the command syntax may vary from platform
 616  to platform). </P
 617 ><P
 618 > <TT
 619 CLASS="FILENAME"
 620 >/etc/passwd</TT
 621 > might then look like:</P
 622 ><P
 623 > <TABLE
 624 BORDER="0"
 625 BGCOLOR="#E0E0E0"
 626 WIDTH="100%"
 627 ><TR
 628 ><TD
 629 ><PRE
 630 CLASS="SCREEN"
 631 >  privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE
 632 ></TD
 633 ></TR
 634 ></TABLE
 635 ></P
 636 ><P
 637 > And then <TT
 638 CLASS="FILENAME"
 639 >/etc/group</TT
 640 >, like:</P
 641 ><P
 642 > <TABLE
 643 BORDER="0"
 644 BGCOLOR="#E0E0E0"
 645 WIDTH="100%"
 646 ><TR
 647 ><TD
 648 ><PRE
 649 CLASS="SCREEN"
 650 >  privoxy:*:7777:</PRE
 651 ></TD
 652 ></TR
 653 ></TABLE
 654 ></P
 655 ><P
 656 > Some binary packages may do this for you.</P
 657 ><P
 658 > Then, to build from either unpacked tarball or CVS source:</P
 659 ><P
 660 > <TABLE
 661 BORDER="0"
 662 BGCOLOR="#E0E0E0"
 663 WIDTH="100%"
 664 ><TR
 665 ><TD
 666 ><PRE
 667 CLASS="SCREEN"
 668 > autoheader
 669  autoconf
 670  ./configure      # (--help to see options)
 671  make             # (the make from GNU, sometimes called gmake)
 672  su               # Possibly required
 673  make -n install  # (to see where all the files will go)
 674  make -s install  # (to really install, -s to silence output)</PRE
 675 ></TD
 676 ></TR
 677 ></TABLE
 678 ></P
 679 ><P
 680 >  Using GNU <B
 681 CLASS="COMMAND"
 682 >make</B
 683 >, you can have the first four steps
 684   automatically done for you by just typing:</P
 685 ><P
 686 > <TABLE
 687 BORDER="0"
 688 BGCOLOR="#E0E0E0"
 689 WIDTH="100%"
 690 ><TR
 691 ><TD
 692 ><PRE
 693 CLASS="SCREEN"
 694 >  make</PRE
 695 ></TD
 696 ></TR
 697 ></TABLE
 698 ></P
 699 ><P
 700 >  in the freshly downloaded or unpacked source directory.</P
 701 ><P
 702 > To build an executable with security enhanced features so that
 703  users cannot easily bypass the proxy (e.g. <SPAN
 704 CLASS="QUOTE"
 705 >"Go There Anyway"</SPAN
 706 >), or
 707  alter their own configurations, <B
 708 CLASS="COMMAND"
 709 >configure</B
 710 > like this:</P
 711 ><P
 712 > <TABLE
 713 BORDER="0"
 714 BGCOLOR="#E0E0E0"
 715 WIDTH="100%"
 716 ><TR
 717 ><TD
 718 ><PRE
 719 CLASS="SCREEN"
 720 > ./configure  --disable-toggle  --disable-editor  --disable-force</PRE
 721 ></TD
 722 ></TR
 723 ></TABLE
 724 ></P
 725 ><P
 726 >Then build as above.</P
 727 ><P
 728 > <SPAN
 729 CLASS="emphasis"
 730 ><I
 731 CLASS="EMPHASIS"
 732 >WARNING:</I
 733 ></SPAN
 734 > If installing as root, the install will fail
 735  unless a non-root user or group is specified, or a <TT
 736 CLASS="LITERAL"
 737 >privoxy</TT
 738 >
 739  user and group already exist on the system. If a non-root user is specified,
 740  and no group, then the installation will try to also use a group of the same name
 741  as <SPAN
 742 CLASS="QUOTE"
 743 >"user"</SPAN
 744 >. If a group is specified (and no user), then the
 745  support files will be installed as writable by that group, and owned by the
 746  user running the installation.</P
 747 ><P
 748 > <B
 749 CLASS="COMMAND"
 750 >configure</B
 751 > accepts <TT
 752 CLASS="LITERAL"
 753 >--with-user</TT
 754 > and
 755  <TT
 756 CLASS="LITERAL"
 757 >--with-group</TT
 758 > options for setting user and group ownership
 759  of the configuration files (which need to be writable by the daemon). The
 760  specified <SPAN
 761 CLASS="emphasis"
 762 ><I
 763 CLASS="EMPHASIS"
 764 >user must already exist</I
 765 ></SPAN
 766 >. When starting
 767  <SPAN
 768 CLASS="APPLICATION"
 769 >Privoxy</SPAN
 770 >, it must be run as this same user to
 771  insure write access to configuration and log files!</P
 772 ><P
 773 > Alternately, you can specify <TT
 774 CLASS="LITERAL"
 775 >user</TT
 776 > and <TT
 777 CLASS="LITERAL"
 778 >group</TT
 779 >
 780  on the <B
 781 CLASS="COMMAND"
 782 >make</B
 783 > command line, but be sure both already exist:</P
 784 ><P
 785 > <TABLE
 786 BORDER="0"
 787 BGCOLOR="#E0E0E0"
 788 WIDTH="100%"
 789 ><TR
 790 ><TD
 791 ><PRE
 792 CLASS="SCREEN"
 793 > make -s install  USER=privoxy GROUP=privoxy</PRE
 794 ></TD
 795 ></TR
 796 ></TABLE
 797 ></P
 798 ><P
 799 > The default installation path for <B
 800 CLASS="COMMAND"
 801 >make install</B
 802 > is
 803  <TT
 804 CLASS="FILENAME"
 805 >/usr/local</TT
 806 >. This may of course be customized with
 807  the various <B
 808 CLASS="COMMAND"
 809 >./configure</B
 810 > path options. If you are doing
 811  an install to anywhere besides <TT
 812 CLASS="FILENAME"
 813 >/usr/local</TT
 814 >, be
 815  sure to set the appropriate paths with the correct configure options
 816  (<B
 817 CLASS="COMMAND"
 818 >./configure --help</B
 819 >). Non-privileged users must of course
 820  have write access permissions to wherever the target installation is going.</P
 821 ><P
 822 > If you do install to <TT
 823 CLASS="FILENAME"
 824 >/usr/local</TT
 825 >, the install will use
 826  <TT
 827 CLASS="LITERAL"
 828 >sysconfdir=$prefix/etc/privoxy</TT
 829 > by default. All other
 830  destinations, and the direct usage of <TT
 831 CLASS="LITERAL"
 832 >--sysconfdir</TT
 833 > flag
 834  behave like normal, i.e. will not add the extra <TT
 835 CLASS="FILENAME"
 836 >privoxy</TT
 837 >
 838  directory. This is for a safer install, as there may already exist another
 839  program that uses a file with the <SPAN
 840 CLASS="QUOTE"
 841 >"config"</SPAN
 842 > name, and thus makes
 843  <TT
 844 CLASS="FILENAME"
 845 >/usr/local/etc</TT
 846 > cleaner.</P
 847 ><P
 848 > If installing to <TT
 849 CLASS="FILENAME"
 850 >/usr/local</TT
 851 >, the documentation will go
 852  by default to <TT
 853 CLASS="FILENAME"
 854 >$prefix/share/doc</TT
 855 >. But if this directory
 856  doesn't exist, it will then try <TT
 857 CLASS="FILENAME"
 858 >$prefix/doc</TT
 859 > and install
 860  there before creating a new <TT
 861 CLASS="FILENAME"
 862 >$prefix/share/doc</TT
 863 > just for
 864  <SPAN
 865 CLASS="APPLICATION"
 866 >Privoxy</SPAN
 867 >.</P
 868 ><P
 869 > Again, if the installs goes to <TT
 870 CLASS="FILENAME"
 871 >/usr/local</TT
 872 >, the
 873  <TT
 874 CLASS="LITERAL"
 875 >localstatedir</TT
 876 > (ie: <TT
 877 CLASS="FILENAME"
 878 >var/</TT
 879 >) will default
 880  to <TT
 881 CLASS="FILENAME"
 882 >/var</TT
 883 > instead of <TT
 884 CLASS="LITERAL"
 885 >$prefix/var</TT
 886 > so
 887  the logs will go to <TT
 888 CLASS="FILENAME"
 889 >/var/log/privoxy/</TT
 890 >, and the pid file
 891  will be created in <TT
 892 CLASS="FILENAME"
 893 >/var/run/privoxy.pid</TT
 894 >. </P
 895 ><P
 896 > <B
 897 CLASS="COMMAND"
 898 >make install</B
 899 > will attempt to set the correct values
 900  in <TT
 901 CLASS="FILENAME"
 902 >config</TT
 903 > (main configuration file). You should
 904  check this to make sure all values are correct. If appropriate,
 905  an init script will be installed, but it is up to the user to determine
 906  how and where to start <SPAN
 907 CLASS="APPLICATION"
 908 >Privoxy</SPAN
 909 >. The init
 910  script should be checked for correct paths and values, if anything other than
 911  a default install is done.</P
 912 ><P
 913 > If install finds previous versions of local configuration files, most of
 914  these will not be overwritten, and the new ones will be installed with a
 915  <SPAN
 916 CLASS="QUOTE"
 917 >"new"</SPAN
 918 > extension. default.action, default.filter, and
 919  standard.action <SPAN
 920 CLASS="emphasis"
 921 ><I
 922 CLASS="EMPHASIS"
 923 >will be overwritten</I
 924 ></SPAN
 925 >. You will then need
 926  to manually update the other installed configuration files as needed. All
 927  template files will be overwritten. If you have customized, local templates,
 928  you should save these first, and in fact it is wise to always save any
 929  important configuration files <SPAN
 930 CLASS="QUOTE"
 931 >"just in case"</SPAN
 932 >. If a previous
 933  version of <SPAN
 934 CLASS="APPLICATION"
 935 >Privoxy</SPAN
 936 > is already running, you will
 937  have to restart it manually.</P
 938 ><P
 939 > For more detailed instructions on how to build Redhat RPMs,
 940  Windows self-extracting installers, building on platforms with
 941  special requirements etc, please consult the <A
 942 HREF="../developer-manual/newrelease.html"
 943 TARGET="_top"
 944 >developer manual</A
 945 >.</P
 946 ></DIV
 947 ><DIV
 948 CLASS="SECT2"
 949 ><H2
 950 CLASS="SECT2"
 951 ><A
 952 NAME="INSTALLATION-KEEPUPDATED"
 953 ></A
 954 >2.3. Keeping your Installation Up-to-Date</H2
 955 ><P
 956 > As user feedback comes in and development continues, we will make updated versions
 957  of both the main <A
 958 HREF="actions-file.html"
 959 >actions file</A
 960 > (as a <A
 961 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&release_id=103670"
 962 TARGET="_top"
 963 >separate
 964  package</A
 965 >) and the software itself (including the actions file) available for
 966  download.</P
 967 ><P
 968 > If you wish to receive an email notification whenever we release updates of
 969  <SPAN
 970 CLASS="APPLICATION"
 971 >Privoxy</SPAN
 972 > or the actions file, <A
 973 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 974 TARGET="_top"
 975 >subscribe
 976  to our announce  mailing list</A
 977 >, ijbswa-announce@lists.sourceforge.net.</P
 978 ><P
 979 > In order not to lose your personal changes and adjustments when updating
 980  to the latest <TT
 981 CLASS="LITERAL"
 982 >default.action</TT
 983 > file we <SPAN
 984 CLASS="emphasis"
 985 ><I
 986 CLASS="EMPHASIS"
 987 >strongly
 988  recommend</I
 989 ></SPAN
 990 > that you use <TT
 991 CLASS="LITERAL"
 992 >user.action</TT
 993 > and
 994  <TT
 995 CLASS="LITERAL"
 996 >user.filter</TT
 997 > for your local
 998  customizations of <SPAN
 999 CLASS="APPLICATION"
1000 >Privoxy</SPAN
1001 >. See the <A
1002 HREF="actions-file.html"
1003 >Chapter on actions files</A
1004 > for details.</P
1005 ></DIV
1006 ></DIV
1007 ><DIV
1008 CLASS="NAVFOOTER"
1009 ><HR
1010 ALIGN="LEFT"
1011 WIDTH="100%"><TABLE
1012 SUMMARY="Footer navigation table"
1013 WIDTH="100%"
1014 BORDER="0"
1015 CELLPADDING="0"
1016 CELLSPACING="0"
1017 ><TR
1018 ><TD
1019 WIDTH="33%"
1020 ALIGN="left"
1021 VALIGN="top"
1022 ><A
1023 HREF="introduction.html"
1024 ACCESSKEY="P"
1025 >Prev</A
1026 ></TD
1027 ><TD
1028 WIDTH="34%"
1029 ALIGN="center"
1030 VALIGN="top"
1031 ><A
1032 HREF="index.html"
1033 ACCESSKEY="H"
1034 >Home</A
1035 ></TD
1036 ><TD
1037 WIDTH="33%"
1038 ALIGN="right"
1039 VALIGN="top"
1040 ><A
1041 HREF="whatsnew.html"
1042 ACCESSKEY="N"
1043 >Next</A
1044 ></TD
1045 ></TR
1046 ><TR
1047 ><TD
1048 WIDTH="33%"
1049 ALIGN="left"
1050 VALIGN="top"
1051 >Introduction</TD
1052 ><TD
1053 WIDTH="34%"
1054 ALIGN="center"
1055 VALIGN="top"
1056 >&nbsp;</TD
1057 ><TD
1058 WIDTH="33%"
1059 ALIGN="right"
1060 VALIGN="top"
1061 >What's New in this Release</TD
1062 ></TR
1063 ></TABLE
1064 ></DIV
1065 ></BODY
1066 ></HTML
1067 >