doc/webserver/user-manual/installation.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Installation</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.16 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"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1">
  24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
  25 </head
  26 ><BODY
  27 CLASS="SECT1"
  28 BGCOLOR="#EEEEEE"
  29 TEXT="#000000"
  30 LINK="#0000FF"
  31 VLINK="#840084"
  32 ALINK="#0000FF"
  33 ><DIV
  34 CLASS="NAVHEADER"
  35 ><TABLE
  36 SUMMARY="Header navigation table"
  37 WIDTH="100%"
  38 BORDER="0"
  39 CELLPADDING="0"
  40 CELLSPACING="0"
  41 ><TR
  42 ><TH
  43 COLSPAN="3"
  44 ALIGN="center"
  45 >Privoxy 3.0.16 User Manual</TH
  46 ></TR
  47 ><TR
  48 ><TD
  49 WIDTH="10%"
  50 ALIGN="left"
  51 VALIGN="bottom"
  52 ><A
  53 HREF="introduction.html"
  54 ACCESSKEY="P"
  55 >Prev</A
  56 ></TD
  57 ><TD
  58 WIDTH="80%"
  59 ALIGN="center"
  60 VALIGN="bottom"
  61 ></TD
  62 ><TD
  63 WIDTH="10%"
  64 ALIGN="right"
  65 VALIGN="bottom"
  66 ><A
  67 HREF="whatsnew.html"
  68 ACCESSKEY="N"
  69 >Next</A
  70 ></TD
  71 ></TR
  72 ></TABLE
  73 ><HR
  74 ALIGN="LEFT"
  75 WIDTH="100%"></DIV
  76 ><DIV
  77 CLASS="SECT1"
  78 ><H1
  79 CLASS="SECT1"
  80 ><A
  81 NAME="INSTALLATION"
  82 >2. Installation</A
  83 ></H1
  84 ><P
  85 > <SPAN
  86 CLASS="APPLICATION"
  87 >Privoxy</SPAN
  88 > is available both in convenient pre-compiled
  89  packages for a wide range of operating systems, and as raw source code.
  90  For most users, we recommend using the packages, which can be downloaded from our
  91  <A
  92 HREF="http://sourceforge.net/projects/ijbswa/"
  93 TARGET="_top"
  94 >Privoxy Project
  95  Page</A
  96 >.</P
  97 ><P
  98 > Note:
  99  On some platforms, the installer may remove previously installed versions, if
 100  found. (See below for your platform). In any case <SPAN
 101 CLASS="emphasis"
 102 ><I
 103 CLASS="EMPHASIS"
 104 >be sure to backup
 105  your old configuration if it is valuable to you.</I
 106 ></SPAN
 107 > See the <A
 108 HREF="whatsnew.html#UPGRADERSNOTE"
 109 >note to upgraders</A
 110 > section below.</P
 111 ><DIV
 112 CLASS="SECT2"
 113 ><H2
 114 CLASS="SECT2"
 115 ><A
 116 NAME="INSTALLATION-PACKAGES"
 117 >2.1. Binary Packages</A
 118 ></H2
 119 ><P
 120 >How to install the binary packages depends on your operating system:</P
 121 ><DIV
 122 CLASS="SECT3"
 123 ><H3
 124 CLASS="SECT3"
 125 ><A
 126 NAME="INSTALLATION-PACK-RPM"
 127 >2.1.1. Red Hat and Fedora RPMs</A
 128 ></H3
 129 ><P
 130 > RPMs can be installed with <TT
 131 CLASS="LITERAL"
 132 >rpm -Uvh privoxy-3.0.16-1.rpm</TT
 133 >,
 134  and will use <TT
 135 CLASS="FILENAME"
 136 >/etc/privoxy</TT
 137 > for the location
 138  of configuration files.</P
 139 ><P
 140 > Note that on Red Hat, <SPAN
 141 CLASS="APPLICATION"
 142 >Privoxy</SPAN
 143 > will
 144  <SPAN
 145 CLASS="emphasis"
 146 ><I
 147 CLASS="EMPHASIS"
 148 >not</I
 149 ></SPAN
 150 > be automatically started on system boot. You will
 151  need to enable that using <B
 152 CLASS="COMMAND"
 153 >chkconfig</B
 154 >,
 155  <B
 156 CLASS="COMMAND"
 157 >ntsysv</B
 158 >, or similar methods. </P
 159 ><P
 160 > If you have problems with failed dependencies, try rebuilding the SRC RPM:
 161  <TT
 162 CLASS="LITERAL"
 163 >rpm --rebuild privoxy-3.0.16-1.src.rpm</TT
 164 >. This
 165  will use your locally installed libraries and RPM version. </P
 166 ><P
 167 > Also note that if you have a <SPAN
 168 CLASS="APPLICATION"
 169 >Junkbuster</SPAN
 170 > RPM installed
 171  on your system, you need to remove it first, because the packages conflict.
 172  Otherwise, RPM will try to remove <SPAN
 173 CLASS="APPLICATION"
 174 >Junkbuster</SPAN
 175 >
 176  automatically if found, before installing <SPAN
 177 CLASS="APPLICATION"
 178 >Privoxy</SPAN
 179 >.</P
 180 ></DIV
 181 ><DIV
 182 CLASS="SECT3"
 183 ><H3
 184 CLASS="SECT3"
 185 ><A
 186 NAME="INSTALLATION-DEB"
 187 >2.1.2. Debian and Ubuntu</A
 188 ></H3
 189 ><P
 190 > DEBs can be installed with <TT
 191 CLASS="LITERAL"
 192 >apt-get install privoxy</TT
 193 >,
 194  and will use <TT
 195 CLASS="FILENAME"
 196 >/etc/privoxy</TT
 197 > for the location of
 198  configuration files.</P
 199 ></DIV
 200 ><DIV
 201 CLASS="SECT3"
 202 ><H3
 203 CLASS="SECT3"
 204 ><A
 205 NAME="INSTALLATION-PACK-WIN"
 206 >2.1.3. Windows</A
 207 ></H3
 208 ><P
 209 > Just double-click the installer, which will guide you through
 210  the installation process. You will find the configuration files
 211  in the same directory as you installed <SPAN
 212 CLASS="APPLICATION"
 213 >Privoxy</SPAN
 214 > in. </P
 215 ><P
 216 > Version 3.0.5 beta introduced full <SPAN
 217 CLASS="APPLICATION"
 218 >Windows</SPAN
 219 > service
 220  functionality. On Windows only, the <SPAN
 221 CLASS="APPLICATION"
 222 >Privoxy</SPAN
 223 >
 224  program has two new command line arguments to install and uninstall
 225  <SPAN
 226 CLASS="APPLICATION"
 227 >Privoxy</SPAN
 228 > as a <SPAN
 229 CLASS="emphasis"
 230 ><I
 231 CLASS="EMPHASIS"
 232 >service</I
 233 ></SPAN
 234 >.</P
 235 ><P
 236 ></P
 237 ><DIV
 238 CLASS="VARIABLELIST"
 239 ><DL
 240 ><DT
 241 >Arguments:</DT
 242 ><DD
 243 ><P
 244 >     <TT
 245 CLASS="REPLACEABLE"
 246 ><I
 247 >--install</I
 248 ></TT
 249 >[:<TT
 250 CLASS="REPLACEABLE"
 251 ><I
 252 >service_name</I
 253 ></TT
 254 >]
 255     </P
 256 ><P
 257 >     <TT
 258 CLASS="REPLACEABLE"
 259 ><I
 260 >--uninstall</I
 261 ></TT
 262 >[:<TT
 263 CLASS="REPLACEABLE"
 264 ><I
 265 >service_name</I
 266 ></TT
 267 >]
 268     </P
 269 ></DD
 270 ></DL
 271 ></DIV
 272 ><P
 273 > After invoking <SPAN
 274 CLASS="APPLICATION"
 275 >Privoxy</SPAN
 276 > with
 277  <B
 278 CLASS="COMMAND"
 279 >--install</B
 280 >, you will need to bring up the
 281  <SPAN
 282 CLASS="APPLICATION"
 283 >Windows</SPAN
 284 > service console to assign the user you
 285  want <SPAN
 286 CLASS="APPLICATION"
 287 >Privoxy</SPAN
 288 > to run under, and whether or not you
 289  want it to run whenever the system starts. You can start the
 290  <SPAN
 291 CLASS="APPLICATION"
 292 >Windows</SPAN
 293 > services console with the following
 294  command: <B
 295 CLASS="COMMAND"
 296 >services.msc</B
 297 >.  If you do not take the manual step
 298  of modifying <SPAN
 299 CLASS="APPLICATION"
 300 >Privoxy's</SPAN
 301 > service settings, it will
 302  not start.  Note too that you will need to give Privoxy a user account that
 303  actually exists, or it will not be permitted to
 304  write to its log and configuration files.</P
 305 ></DIV
 306 ><DIV
 307 CLASS="SECT3"
 308 ><H3
 309 CLASS="SECT3"
 310 ><A
 311 NAME="INSTALLATION-PACK-BINTGZ"
 312 >2.1.4. Solaris</A
 313 ></H3
 314 ><P
 315 > Create a new directory, <TT
 316 CLASS="LITERAL"
 317 >cd</TT
 318 > to it, then unzip and
 319  untar the archive. For the most part, you'll have to figure out where
 320  things go. </P
 321 ></DIV
 322 ><DIV
 323 CLASS="SECT3"
 324 ><H3
 325 CLASS="SECT3"
 326 ><A
 327 NAME="INSTALLATION-OS2"
 328 >2.1.5. OS/2</A
 329 ></H3
 330 ><P
 331 > First, make sure that no previous installations of
 332  <SPAN
 333 CLASS="APPLICATION"
 334 >Junkbuster</SPAN
 335 > and / or
 336  <SPAN
 337 CLASS="APPLICATION"
 338 >Privoxy</SPAN
 339 > are left on your
 340  system. Check that no <SPAN
 341 CLASS="APPLICATION"
 342 >Junkbuster</SPAN
 343 >
 344  or <SPAN
 345 CLASS="APPLICATION"
 346 >Privoxy</SPAN
 347 > objects are in
 348  your startup folder.&#13;</P
 349 ><P
 350 > Then, just double-click the WarpIN self-installing archive, which will
 351  guide you through the installation process. A shadow of the
 352  <SPAN
 353 CLASS="APPLICATION"
 354 >Privoxy</SPAN
 355 > executable will be placed in your
 356  startup folder so it will start automatically whenever OS/2 starts.</P
 357 ><P
 358 > The directory you choose to install <SPAN
 359 CLASS="APPLICATION"
 360 >Privoxy</SPAN
 361 >
 362  into will contain all of the configuration files.</P
 363 ></DIV
 364 ><DIV
 365 CLASS="SECT3"
 366 ><H3
 367 CLASS="SECT3"
 368 ><A
 369 NAME="INSTALLATION-MAC"
 370 >2.1.6. Mac OS X</A
 371 ></H3
 372 ><P
 373 > Unzip the downloaded file (you can either double-click on the zip file
 374  icon from the Finder, or from the desktop if you downloaded it there).
 375  Then, double-click on the package installer icon and follow the
 376  installation process.</P
 377 ><P
 378 > The privoxy service will automatically start after a successful
 379  installation (in addition to every time your computer starts up).  To
 380  prevent the privoxy service from automatically starting when your
 381  computer starts up, remove or rename the folder named
 382  <TT
 383 CLASS="LITERAL"
 384 >/Library/StartupItems/Privoxy</TT
 385 >. </P
 386 ><P
 387 > To manually start or stop the privoxy service, use the Privoxy Utility
 388  for Mac OS X.  This application controls the privoxy service (e.g.
 389  starting and stopping the service as well as uninstalling the software).</P
 390 ></DIV
 391 ><DIV
 392 CLASS="SECT3"
 393 ><H3
 394 CLASS="SECT3"
 395 ><A
 396 NAME="INSTALLATION-AMIGA"
 397 >2.1.7. AmigaOS</A
 398 ></H3
 399 ><P
 400 > Copy and then unpack the <TT
 401 CLASS="FILENAME"
 402 >lha</TT
 403 > archive to a suitable location.
 404  All necessary files will be installed into <SPAN
 405 CLASS="APPLICATION"
 406 >Privoxy</SPAN
 407 >
 408  directory, including all configuration and log files. To uninstall, just
 409  remove this directory.</P
 410 ></DIV
 411 ><DIV
 412 CLASS="SECT3"
 413 ><H3
 414 CLASS="SECT3"
 415 ><A
 416 NAME="INSTALLATION-TBZ"
 417 >2.1.8. FreeBSD</A
 418 ></H3
 419 ><P
 420 > Privoxy is part of FreeBSD's Ports Collection, you can build and install
 421  it with <TT
 422 CLASS="LITERAL"
 423 >cd /usr/ports/www/privoxy; make install clean</TT
 424 >.</P
 425 ><P
 426 > If you don't use the ports, you can fetch and install
 427  the package with <TT
 428 CLASS="LITERAL"
 429 >pkg_add -r privoxy</TT
 430 >.</P
 431 ><P
 432 > The port skeleton and the package can also be downloaded from the
 433  <A
 434 HREF="https://sourceforge.net/project/showfiles.php?group_id=11118"
 435 TARGET="_top"
 436 >File Release
 437  Page</A
 438 >, but there's no reason to use them unless you're interested in the
 439  beta releases which are only available there.</P
 440 ></DIV
 441 ><DIV
 442 CLASS="SECT3"
 443 ><H3
 444 CLASS="SECT3"
 445 ><A
 446 NAME="INSTALLATTION-GENTOO"
 447 >2.1.9. Gentoo</A
 448 ></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 --sync</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.16</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 >2.2. Building from Source</A
 496 ></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&#38;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.16-beta-src.tar.gz
 551  cd privoxy-3.0.16-beta</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. In Privoxy 3.0.7 and later, all of these options
 727 can also be disabled through the configuration file.</P
 728 ><P
 729 > <SPAN
 730 CLASS="emphasis"
 731 ><I
 732 CLASS="EMPHASIS"
 733 >WARNING:</I
 734 ></SPAN
 735 > If installing as root, the install will fail
 736  unless a non-root user or group is specified, or a <TT
 737 CLASS="LITERAL"
 738 >privoxy</TT
 739 >
 740  user and group already exist on the system. If a non-root user is specified,
 741  and no group, then the installation will try to also use a group of the same name
 742  as <SPAN
 743 CLASS="QUOTE"
 744 >"user"</SPAN
 745 >. If a group is specified (and no user), then the
 746  support files will be installed as writable by that group, and owned by the
 747  user running the installation.</P
 748 ><P
 749 > <B
 750 CLASS="COMMAND"
 751 >configure</B
 752 > accepts <TT
 753 CLASS="LITERAL"
 754 >--with-user</TT
 755 > and
 756  <TT
 757 CLASS="LITERAL"
 758 >--with-group</TT
 759 > options for setting user and group ownership
 760  of the configuration files (which need to be writable by the daemon). The
 761  specified <SPAN
 762 CLASS="emphasis"
 763 ><I
 764 CLASS="EMPHASIS"
 765 >user must already exist</I
 766 ></SPAN
 767 >. When starting
 768  <SPAN
 769 CLASS="APPLICATION"
 770 >Privoxy</SPAN
 771 >, it must be run as this same user to
 772  insure write access to configuration and log files!</P
 773 ><P
 774 > Alternately, you can specify <TT
 775 CLASS="LITERAL"
 776 >user</TT
 777 > and <TT
 778 CLASS="LITERAL"
 779 >group</TT
 780 >
 781  on the <B
 782 CLASS="COMMAND"
 783 >make</B
 784 > command line, but be sure both already exist:</P
 785 ><P
 786 > <TABLE
 787 BORDER="0"
 788 BGCOLOR="#E0E0E0"
 789 WIDTH="100%"
 790 ><TR
 791 ><TD
 792 ><PRE
 793 CLASS="SCREEN"
 794 > make -s install  USER=privoxy GROUP=privoxy</PRE
 795 ></TD
 796 ></TR
 797 ></TABLE
 798 ></P
 799 ><P
 800 > The default installation path for <B
 801 CLASS="COMMAND"
 802 >make install</B
 803 > is
 804  <TT
 805 CLASS="FILENAME"
 806 >/usr/local</TT
 807 >. This may of course be customized with
 808  the various <B
 809 CLASS="COMMAND"
 810 >./configure</B
 811 > path options. If you are doing
 812  an install to anywhere besides <TT
 813 CLASS="FILENAME"
 814 >/usr/local</TT
 815 >, be
 816  sure to set the appropriate paths with the correct configure options
 817  (<B
 818 CLASS="COMMAND"
 819 >./configure --help</B
 820 >). Non-privileged users must of course
 821  have write access permissions to wherever the target installation is going.</P
 822 ><P
 823 > If you do install to <TT
 824 CLASS="FILENAME"
 825 >/usr/local</TT
 826 >, the install will use
 827  <TT
 828 CLASS="LITERAL"
 829 >sysconfdir=$prefix/etc/privoxy</TT
 830 > by default. All other
 831  destinations, and the direct usage of <TT
 832 CLASS="LITERAL"
 833 >--sysconfdir</TT
 834 > flag
 835  behave like normal, i.e. will not add the extra <TT
 836 CLASS="FILENAME"
 837 >privoxy</TT
 838 >
 839  directory. This is for a safer install, as there may already exist another
 840  program that uses a file with the <SPAN
 841 CLASS="QUOTE"
 842 >"config"</SPAN
 843 > name, and thus makes
 844  <TT
 845 CLASS="FILENAME"
 846 >/usr/local/etc</TT
 847 > cleaner.</P
 848 ><P
 849 > If installing to <TT
 850 CLASS="FILENAME"
 851 >/usr/local</TT
 852 >, the documentation will go
 853  by default to <TT
 854 CLASS="FILENAME"
 855 >$prefix/share/doc</TT
 856 >. But if this directory
 857  doesn't exist, it will then try <TT
 858 CLASS="FILENAME"
 859 >$prefix/doc</TT
 860 > and install
 861  there before creating a new <TT
 862 CLASS="FILENAME"
 863 >$prefix/share/doc</TT
 864 > just for
 865  <SPAN
 866 CLASS="APPLICATION"
 867 >Privoxy</SPAN
 868 >.</P
 869 ><P
 870 > Again, if the installs goes to <TT
 871 CLASS="FILENAME"
 872 >/usr/local</TT
 873 >, the
 874  <TT
 875 CLASS="LITERAL"
 876 >localstatedir</TT
 877 > (ie: <TT
 878 CLASS="FILENAME"
 879 >var/</TT
 880 >) will default
 881  to <TT
 882 CLASS="FILENAME"
 883 >/var</TT
 884 > instead of <TT
 885 CLASS="LITERAL"
 886 >$prefix/var</TT
 887 > so
 888  the logs will go to <TT
 889 CLASS="FILENAME"
 890 >/var/log/privoxy/</TT
 891 >, and the pid file
 892  will be created in <TT
 893 CLASS="FILENAME"
 894 >/var/run/privoxy.pid</TT
 895 >. </P
 896 ><P
 897 > <B
 898 CLASS="COMMAND"
 899 >make install</B
 900 > will attempt to set the correct values
 901  in <TT
 902 CLASS="FILENAME"
 903 >config</TT
 904 > (main configuration file). You should
 905  check this to make sure all values are correct. If appropriate,
 906  an init script will be installed, but it is up to the user to determine
 907  how and where to start <SPAN
 908 CLASS="APPLICATION"
 909 >Privoxy</SPAN
 910 >. The init
 911  script should be checked for correct paths and values, if anything other than
 912  a default install is done.</P
 913 ><P
 914 > If install finds previous versions of local configuration files, most of
 915  these will not be overwritten, and the new ones will be installed with a
 916  <SPAN
 917 CLASS="QUOTE"
 918 >"new"</SPAN
 919 > extension. default.action and default.filter
 920  <SPAN
 921 CLASS="emphasis"
 922 ><I
 923 CLASS="EMPHASIS"
 924 >will be overwritten</I
 925 ></SPAN
 926 >. You will then need
 927  to manually update the other installed configuration files as needed. The
 928  default template files <SPAN
 929 CLASS="emphasis"
 930 ><I
 931 CLASS="EMPHASIS"
 932 >will</I
 933 ></SPAN
 934 > be overwritten. If you have
 935  customized, local templates, these should be stored safely in a separate
 936  directory and defined in <TT
 937 CLASS="FILENAME"
 938 >config</TT
 939 > by the
 940  <SPAN
 941 CLASS="QUOTE"
 942 >"templdir"</SPAN
 943 > directive. It is of course wise to always back-up any
 944  important configuration files <SPAN
 945 CLASS="QUOTE"
 946 >"just in case"</SPAN
 947 >. If a previous
 948  version of <SPAN
 949 CLASS="APPLICATION"
 950 >Privoxy</SPAN
 951 > is already running, you will
 952  have to restart it manually.</P
 953 ><P
 954 > For more detailed instructions on how to build Redhat RPMs,
 955  Windows self-extracting installers, building on platforms with
 956  special requirements etc, please consult the <A
 957 HREF="http://www.privoxy.org/developer-manual/newrelease.html"
 958 TARGET="_top"
 959 >developer manual</A
 960 >.</P
 961 ></DIV
 962 ><DIV
 963 CLASS="SECT2"
 964 ><H2
 965 CLASS="SECT2"
 966 ><A
 967 NAME="INSTALLATION-KEEPUPDATED"
 968 >2.3. Keeping your Installation Up-to-Date</A
 969 ></H2
 970 ><P
 971 > As user feedback comes in and development continues, we will make updated versions
 972  of both the main <A
 973 HREF="actions-file.html"
 974 >actions file</A
 975 > (as a <A
 976 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&#38;release_id=103670"
 977 TARGET="_top"
 978 >separate
 979  package</A
 980 >) and the software itself (including the actions file) available for
 981  download.</P
 982 ><P
 983 > If you wish to receive an email notification whenever we release updates of
 984  <SPAN
 985 CLASS="APPLICATION"
 986 >Privoxy</SPAN
 987 > or the actions file, <A
 988 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 989 TARGET="_top"
 990 >subscribe
 991  to our announce  mailing list</A
 992 >, ijbswa-announce@lists.sourceforge.net.</P
 993 ><P
 994 > In order not to lose your personal changes and adjustments when updating
 995  to the latest <TT
 996 CLASS="LITERAL"
 997 >default.action</TT
 998 > file we <SPAN
 999 CLASS="emphasis"
1000 ><I
1001 CLASS="EMPHASIS"
1002 >strongly
1003  recommend</I
1004 ></SPAN
1005 > that you use <TT
1006 CLASS="LITERAL"
1007 >user.action</TT
1008 > and
1009  <TT
1010 CLASS="LITERAL"
1011 >user.filter</TT
1012 > for your local
1013  customizations of <SPAN
1014 CLASS="APPLICATION"
1015 >Privoxy</SPAN
1016 >. See the <A
1017 HREF="actions-file.html"
1018 >Chapter on actions files</A
1019 > for details.</P
1020 ></DIV
1021 ></DIV
1022 ><DIV
1023 CLASS="NAVFOOTER"
1024 ><HR
1025 ALIGN="LEFT"
1026 WIDTH="100%"><TABLE
1027 SUMMARY="Footer navigation table"
1028 WIDTH="100%"
1029 BORDER="0"
1030 CELLPADDING="0"
1031 CELLSPACING="0"
1032 ><TR
1033 ><TD
1034 WIDTH="33%"
1035 ALIGN="left"
1036 VALIGN="top"
1037 ><A
1038 HREF="introduction.html"
1039 ACCESSKEY="P"
1040 >Prev</A
1041 ></TD
1042 ><TD
1043 WIDTH="34%"
1044 ALIGN="center"
1045 VALIGN="top"
1046 ><A
1047 HREF="index.html"
1048 ACCESSKEY="H"
1049 >Home</A
1050 ></TD
1051 ><TD
1052 WIDTH="33%"
1053 ALIGN="right"
1054 VALIGN="top"
1055 ><A
1056 HREF="whatsnew.html"
1057 ACCESSKEY="N"
1058 >Next</A
1059 ></TD
1060 ></TR
1061 ><TR
1062 ><TD
1063 WIDTH="33%"
1064 ALIGN="left"
1065 VALIGN="top"
1066 >Introduction</TD
1067 ><TD
1068 WIDTH="34%"
1069 ALIGN="center"
1070 VALIGN="top"
1071 >&nbsp;</TD
1072 ><TD
1073 WIDTH="33%"
1074 ALIGN="right"
1075 VALIGN="top"
1076 >What's New in this Release</TD
1077 ></TR
1078 ></TABLE
1079 ></DIV
1080 ></BODY
1081 ></HTML
1082 >