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.9 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.9 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.9-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.9-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, download and install the
 388  <A
 389 HREF="https://sourceforge.net/project/showfiles.php?group_id=11118&package_id=29783"
 390 TARGET="_top"
 391 >Privoxy Utility</A
 392 > for Mac OS X.
 393  This application controls the privoxy service (e.g. starting and
 394  stopping the service as well as uninstalling the software).</P
 395 ></DIV
 396 ><DIV
 397 CLASS="SECT3"
 398 ><H3
 399 CLASS="SECT3"
 400 ><A
 401 NAME="INSTALLATION-AMIGA"
 402 >2.1.7. AmigaOS</A
 403 ></H3
 404 ><P
 405 > Copy and then unpack the <TT
 406 CLASS="FILENAME"
 407 >lha</TT
 408 > archive to a suitable location.
 409  All necessary files will be installed into <SPAN
 410 CLASS="APPLICATION"
 411 >Privoxy</SPAN
 412 >
 413  directory, including all configuration and log files. To uninstall, just
 414  remove this directory.</P
 415 ></DIV
 416 ><DIV
 417 CLASS="SECT3"
 418 ><H3
 419 CLASS="SECT3"
 420 ><A
 421 NAME="INSTALLATION-TBZ"
 422 >2.1.8. FreeBSD</A
 423 ></H3
 424 ><P
 425 > Privoxy is part of FreeBSD's Ports Collection, you can build and install
 426  it with <TT
 427 CLASS="LITERAL"
 428 >cd /usr/ports/www/privoxy; make install clean</TT
 429 >.</P
 430 ><P
 431 > If you don't use the ports, you can fetch and install
 432  the package with <TT
 433 CLASS="LITERAL"
 434 >pkg_add -r privoxy</TT
 435 >.</P
 436 ><P
 437 > The port skeleton and the package can also be downloaded from the
 438  <A
 439 HREF="https://sourceforge.net/project/showfiles.php?group_id=11118"
 440 TARGET="_top"
 441 >File Release
 442  Page</A
 443 >, but there's no reason to use them unless you're interested in the
 444  beta releases which are only available there.</P
 445 ></DIV
 446 ><DIV
 447 CLASS="SECT3"
 448 ><H3
 449 CLASS="SECT3"
 450 ><A
 451 NAME="INSTALLATTION-GENTOO"
 452 >2.1.9. Gentoo</A
 453 ></H3
 454 ><P
 455 > Gentoo source packages (Ebuilds) for <SPAN
 456 CLASS="APPLICATION"
 457 >Privoxy</SPAN
 458 > are
 459  contained in the Gentoo  Portage Tree (they are not on the download page,
 460  but there is a Gentoo section, where you can see when a new
 461  <SPAN
 462 CLASS="APPLICATION"
 463 >Privoxy</SPAN
 464 > Version is added to the  Portage Tree).</P
 465 ><P
 466 > Before installing <SPAN
 467 CLASS="APPLICATION"
 468 >Privoxy</SPAN
 469 > under Gentoo just do
 470  first <TT
 471 CLASS="LITERAL"
 472 >emerge rsync</TT
 473 > to get the latest changes from the
 474  Portage tree. With <TT
 475 CLASS="LITERAL"
 476 >emerge privoxy</TT
 477 > you install the latest
 478  version.</P
 479 ><P
 480 > Configuration files are in <TT
 481 CLASS="FILENAME"
 482 >/etc/privoxy</TT
 483 >, the
 484  documentation is in <TT
 485 CLASS="FILENAME"
 486 >/usr/share/doc/privoxy-3.0.9</TT
 487 >
 488  and the Log directory is in <TT
 489 CLASS="FILENAME"
 490 >/var/log/privoxy</TT
 491 >.</P
 492 ></DIV
 493 ></DIV
 494 ><DIV
 495 CLASS="SECT2"
 496 ><H2
 497 CLASS="SECT2"
 498 ><A
 499 NAME="INSTALLATION-SOURCE"
 500 >2.2. Building from Source</A
 501 ></H2
 502 ><P
 503 > The most convenient way to obtain the <SPAN
 504 CLASS="APPLICATION"
 505 >Privoxy</SPAN
 506 > sources
 507  is to download the source tarball from our
 508  <A
 509 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&package_id=10571"
 510 TARGET="_top"
 511 >project download
 512  page</A
 513 >.</P
 514 ><P
 515 > If you like to live on the bleeding edge and are not afraid of using
 516  possibly unstable development versions, you can check out the up-to-the-minute
 517  version directly from <A
 518 HREF="http://sourceforge.net/cvs/?group_id=11118"
 519 TARGET="_top"
 520 >the
 521  CVS repository</A
 522 >. </P
 523 ><P
 524 > To build <SPAN
 525 CLASS="APPLICATION"
 526 >Privoxy</SPAN
 527 > from source,
 528  <A
 529 HREF="http://www.gnu.org/software/autoconf/autoconf.html"
 530 TARGET="_top"
 531 >autoconf</A
 532 >,
 533  <A
 534 HREF="http://www.gnu.org/software/make/make.html"
 535 TARGET="_top"
 536 >GNU make
 537  (gmake)</A
 538 >, and, of course, a C compiler like <A
 539 HREF="http://www.gnu.org/software/gcc/gcc.html"
 540 TARGET="_top"
 541 >gcc</A
 542 > are required.</P
 543 ><P
 544 > When building from a source tarball,
 545  first unpack the source: </P
 546 ><P
 547 > <TABLE
 548 BORDER="0"
 549 BGCOLOR="#E0E0E0"
 550 WIDTH="100%"
 551 ><TR
 552 ><TD
 553 ><PRE
 554 CLASS="SCREEN"
 555 > tar xzvf privoxy-3.0.9-beta-src* [.tgz or .tar.gz]
 556  cd privoxy-3.0.9-beta</PRE
 557 ></TD
 558 ></TR
 559 ></TABLE
 560 ></P
 561 ><P
 562 > For retrieving the current CVS sources, you'll need a CVS client installed.
 563  Note that sources from CVS are typically development quality, and may not be
 564  stable, or well tested. To download CVS source, check the Sourceforge
 565  documentation, which might give commands like:</P
 566 ><P
 567 > <TABLE
 568 BORDER="0"
 569 BGCOLOR="#E0E0E0"
 570 WIDTH="100%"
 571 ><TR
 572 ><TD
 573 ><PRE
 574 CLASS="SCREEN"
 575 >  cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login
 576   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current
 577   cd current</PRE
 578 ></TD
 579 ></TR
 580 ></TABLE
 581 ></P
 582 ><P
 583 > This will create a directory named <TT
 584 CLASS="FILENAME"
 585 >current/</TT
 586 >, which will
 587  contain the source tree.</P
 588 ><P
 589 > You can also check out any <SPAN
 590 CLASS="APPLICATION"
 591 >Privoxy</SPAN
 592 >
 593  <SPAN
 594 CLASS="QUOTE"
 595 >"branch"</SPAN
 596 >, just exchange the <SPAN
 597 CLASS="APPLICATION"
 598 >current</SPAN
 599 >
 600  name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs
 601  tree).</P
 602 ><P
 603 > It is also strongly recommended to not run <SPAN
 604 CLASS="APPLICATION"
 605 >Privoxy</SPAN
 606 >
 607  as root. You should configure/install/run <SPAN
 608 CLASS="APPLICATION"
 609 >Privoxy</SPAN
 610 > as
 611  an unprivileged user, preferably by  creating a <SPAN
 612 CLASS="QUOTE"
 613 >"privoxy"</SPAN
 614 > user
 615  and group just for this purpose. See your local documentation for the correct
 616  command line to do add new users and groups (something like
 617  <B
 618 CLASS="COMMAND"
 619 >adduser</B
 620 >, but the command syntax may vary from platform
 621  to platform). </P
 622 ><P
 623 > <TT
 624 CLASS="FILENAME"
 625 >/etc/passwd</TT
 626 > might then look like:</P
 627 ><P
 628 > <TABLE
 629 BORDER="0"
 630 BGCOLOR="#E0E0E0"
 631 WIDTH="100%"
 632 ><TR
 633 ><TD
 634 ><PRE
 635 CLASS="SCREEN"
 636 >  privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE
 637 ></TD
 638 ></TR
 639 ></TABLE
 640 ></P
 641 ><P
 642 > And then <TT
 643 CLASS="FILENAME"
 644 >/etc/group</TT
 645 >, like:</P
 646 ><P
 647 > <TABLE
 648 BORDER="0"
 649 BGCOLOR="#E0E0E0"
 650 WIDTH="100%"
 651 ><TR
 652 ><TD
 653 ><PRE
 654 CLASS="SCREEN"
 655 >  privoxy:*:7777:</PRE
 656 ></TD
 657 ></TR
 658 ></TABLE
 659 ></P
 660 ><P
 661 > Some binary packages may do this for you.</P
 662 ><P
 663 > Then, to build from either unpacked tarball or CVS source:</P
 664 ><P
 665 > <TABLE
 666 BORDER="0"
 667 BGCOLOR="#E0E0E0"
 668 WIDTH="100%"
 669 ><TR
 670 ><TD
 671 ><PRE
 672 CLASS="SCREEN"
 673 > autoheader
 674  autoconf
 675  ./configure      # (--help to see options)
 676  make             # (the make from GNU, sometimes called gmake)
 677  su               # Possibly required
 678  make -n install  # (to see where all the files will go)
 679  make -s install  # (to really install, -s to silence output)</PRE
 680 ></TD
 681 ></TR
 682 ></TABLE
 683 ></P
 684 ><P
 685 >  Using GNU <B
 686 CLASS="COMMAND"
 687 >make</B
 688 >, you can have the first four steps
 689   automatically done for you by just typing:</P
 690 ><P
 691 > <TABLE
 692 BORDER="0"
 693 BGCOLOR="#E0E0E0"
 694 WIDTH="100%"
 695 ><TR
 696 ><TD
 697 ><PRE
 698 CLASS="SCREEN"
 699 >  make</PRE
 700 ></TD
 701 ></TR
 702 ></TABLE
 703 ></P
 704 ><P
 705 >  in the freshly downloaded or unpacked source directory.</P
 706 ><P
 707 > To build an executable with security enhanced features so that
 708  users cannot easily bypass the proxy (e.g. <SPAN
 709 CLASS="QUOTE"
 710 >"Go There Anyway"</SPAN
 711 >), or
 712  alter their own configurations, <B
 713 CLASS="COMMAND"
 714 >configure</B
 715 > like this:</P
 716 ><P
 717 > <TABLE
 718 BORDER="0"
 719 BGCOLOR="#E0E0E0"
 720 WIDTH="100%"
 721 ><TR
 722 ><TD
 723 ><PRE
 724 CLASS="SCREEN"
 725 > ./configure  --disable-toggle  --disable-editor  --disable-force</PRE
 726 ></TD
 727 ></TR
 728 ></TABLE
 729 ></P
 730 ><P
 731 >Then build as above. In Privoxy 3.0.7 and later, all of these options
 732 can also be disabled through the configuration file.</P
 733 ><P
 734 > <SPAN
 735 CLASS="emphasis"
 736 ><I
 737 CLASS="EMPHASIS"
 738 >WARNING:</I
 739 ></SPAN
 740 > If installing as root, the install will fail
 741  unless a non-root user or group is specified, or a <TT
 742 CLASS="LITERAL"
 743 >privoxy</TT
 744 >
 745  user and group already exist on the system. If a non-root user is specified,
 746  and no group, then the installation will try to also use a group of the same name
 747  as <SPAN
 748 CLASS="QUOTE"
 749 >"user"</SPAN
 750 >. If a group is specified (and no user), then the
 751  support files will be installed as writable by that group, and owned by the
 752  user running the installation.</P
 753 ><P
 754 > <B
 755 CLASS="COMMAND"
 756 >configure</B
 757 > accepts <TT
 758 CLASS="LITERAL"
 759 >--with-user</TT
 760 > and
 761  <TT
 762 CLASS="LITERAL"
 763 >--with-group</TT
 764 > options for setting user and group ownership
 765  of the configuration files (which need to be writable by the daemon). The
 766  specified <SPAN
 767 CLASS="emphasis"
 768 ><I
 769 CLASS="EMPHASIS"
 770 >user must already exist</I
 771 ></SPAN
 772 >. When starting
 773  <SPAN
 774 CLASS="APPLICATION"
 775 >Privoxy</SPAN
 776 >, it must be run as this same user to
 777  insure write access to configuration and log files!</P
 778 ><P
 779 > Alternately, you can specify <TT
 780 CLASS="LITERAL"
 781 >user</TT
 782 > and <TT
 783 CLASS="LITERAL"
 784 >group</TT
 785 >
 786  on the <B
 787 CLASS="COMMAND"
 788 >make</B
 789 > command line, but be sure both already exist:</P
 790 ><P
 791 > <TABLE
 792 BORDER="0"
 793 BGCOLOR="#E0E0E0"
 794 WIDTH="100%"
 795 ><TR
 796 ><TD
 797 ><PRE
 798 CLASS="SCREEN"
 799 > make -s install  USER=privoxy GROUP=privoxy</PRE
 800 ></TD
 801 ></TR
 802 ></TABLE
 803 ></P
 804 ><P
 805 > The default installation path for <B
 806 CLASS="COMMAND"
 807 >make install</B
 808 > is
 809  <TT
 810 CLASS="FILENAME"
 811 >/usr/local</TT
 812 >. This may of course be customized with
 813  the various <B
 814 CLASS="COMMAND"
 815 >./configure</B
 816 > path options. If you are doing
 817  an install to anywhere besides <TT
 818 CLASS="FILENAME"
 819 >/usr/local</TT
 820 >, be
 821  sure to set the appropriate paths with the correct configure options
 822  (<B
 823 CLASS="COMMAND"
 824 >./configure --help</B
 825 >). Non-privileged users must of course
 826  have write access permissions to wherever the target installation is going.</P
 827 ><P
 828 > If you do install to <TT
 829 CLASS="FILENAME"
 830 >/usr/local</TT
 831 >, the install will use
 832  <TT
 833 CLASS="LITERAL"
 834 >sysconfdir=$prefix/etc/privoxy</TT
 835 > by default. All other
 836  destinations, and the direct usage of <TT
 837 CLASS="LITERAL"
 838 >--sysconfdir</TT
 839 > flag
 840  behave like normal, i.e. will not add the extra <TT
 841 CLASS="FILENAME"
 842 >privoxy</TT
 843 >
 844  directory. This is for a safer install, as there may already exist another
 845  program that uses a file with the <SPAN
 846 CLASS="QUOTE"
 847 >"config"</SPAN
 848 > name, and thus makes
 849  <TT
 850 CLASS="FILENAME"
 851 >/usr/local/etc</TT
 852 > cleaner.</P
 853 ><P
 854 > If installing to <TT
 855 CLASS="FILENAME"
 856 >/usr/local</TT
 857 >, the documentation will go
 858  by default to <TT
 859 CLASS="FILENAME"
 860 >$prefix/share/doc</TT
 861 >. But if this directory
 862  doesn't exist, it will then try <TT
 863 CLASS="FILENAME"
 864 >$prefix/doc</TT
 865 > and install
 866  there before creating a new <TT
 867 CLASS="FILENAME"
 868 >$prefix/share/doc</TT
 869 > just for
 870  <SPAN
 871 CLASS="APPLICATION"
 872 >Privoxy</SPAN
 873 >.</P
 874 ><P
 875 > Again, if the installs goes to <TT
 876 CLASS="FILENAME"
 877 >/usr/local</TT
 878 >, the
 879  <TT
 880 CLASS="LITERAL"
 881 >localstatedir</TT
 882 > (ie: <TT
 883 CLASS="FILENAME"
 884 >var/</TT
 885 >) will default
 886  to <TT
 887 CLASS="FILENAME"
 888 >/var</TT
 889 > instead of <TT
 890 CLASS="LITERAL"
 891 >$prefix/var</TT
 892 > so
 893  the logs will go to <TT
 894 CLASS="FILENAME"
 895 >/var/log/privoxy/</TT
 896 >, and the pid file
 897  will be created in <TT
 898 CLASS="FILENAME"
 899 >/var/run/privoxy.pid</TT
 900 >. </P
 901 ><P
 902 > <B
 903 CLASS="COMMAND"
 904 >make install</B
 905 > will attempt to set the correct values
 906  in <TT
 907 CLASS="FILENAME"
 908 >config</TT
 909 > (main configuration file). You should
 910  check this to make sure all values are correct. If appropriate,
 911  an init script will be installed, but it is up to the user to determine
 912  how and where to start <SPAN
 913 CLASS="APPLICATION"
 914 >Privoxy</SPAN
 915 >. The init
 916  script should be checked for correct paths and values, if anything other than
 917  a default install is done.</P
 918 ><P
 919 > If install finds previous versions of local configuration files, most of
 920  these will not be overwritten, and the new ones will be installed with a
 921  <SPAN
 922 CLASS="QUOTE"
 923 >"new"</SPAN
 924 > extension. default.action, default.filter, and
 925  standard.action <SPAN
 926 CLASS="emphasis"
 927 ><I
 928 CLASS="EMPHASIS"
 929 >will be overwritten</I
 930 ></SPAN
 931 >. You will then need
 932  to manually update the other installed configuration files as needed. The
 933  default template files <SPAN
 934 CLASS="emphasis"
 935 ><I
 936 CLASS="EMPHASIS"
 937 >will</I
 938 ></SPAN
 939 > be overwritten. If you have
 940  customized, local templates, these should be stored safely in a separate
 941  directory and defined in <TT
 942 CLASS="FILENAME"
 943 >config</TT
 944 > by the
 945  <SPAN
 946 CLASS="QUOTE"
 947 >"templdir"</SPAN
 948 > directive. It is of course wise to always back-up any
 949  important configuration files <SPAN
 950 CLASS="QUOTE"
 951 >"just in case"</SPAN
 952 >. If a previous
 953  version of <SPAN
 954 CLASS="APPLICATION"
 955 >Privoxy</SPAN
 956 > is already running, you will
 957  have to restart it manually.</P
 958 ><P
 959 > For more detailed instructions on how to build Redhat RPMs,
 960  Windows self-extracting installers, building on platforms with
 961  special requirements etc, please consult the <A
 962 HREF="../developer-manual/newrelease.html"
 963 TARGET="_top"
 964 >developer manual</A
 965 >.</P
 966 ></DIV
 967 ><DIV
 968 CLASS="SECT2"
 969 ><H2
 970 CLASS="SECT2"
 971 ><A
 972 NAME="INSTALLATION-KEEPUPDATED"
 973 >2.3. Keeping your Installation Up-to-Date</A
 974 ></H2
 975 ><P
 976 > As user feedback comes in and development continues, we will make updated versions
 977  of both the main <A
 978 HREF="actions-file.html"
 979 >actions file</A
 980 > (as a <A
 981 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118&release_id=103670"
 982 TARGET="_top"
 983 >separate
 984  package</A
 985 >) and the software itself (including the actions file) available for
 986  download.</P
 987 ><P
 988 > If you wish to receive an email notification whenever we release updates of
 989  <SPAN
 990 CLASS="APPLICATION"
 991 >Privoxy</SPAN
 992 > or the actions file, <A
 993 HREF="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce/"
 994 TARGET="_top"
 995 >subscribe
 996  to our announce  mailing list</A
 997 >, ijbswa-announce@lists.sourceforge.net.</P
 998 ><P
 999 > In order not to lose your personal changes and adjustments when updating
1000  to the latest <TT
1001 CLASS="LITERAL"
1002 >default.action</TT
1003 > file we <SPAN
1004 CLASS="emphasis"
1005 ><I
1006 CLASS="EMPHASIS"
1007 >strongly
1008  recommend</I
1009 ></SPAN
1010 > that you use <TT
1011 CLASS="LITERAL"
1012 >user.action</TT
1013 > and
1014  <TT
1015 CLASS="LITERAL"
1016 >user.filter</TT
1017 > for your local
1018  customizations of <SPAN
1019 CLASS="APPLICATION"
1020 >Privoxy</SPAN
1021 >. See the <A
1022 HREF="actions-file.html"
1023 >Chapter on actions files</A
1024 > for details.</P
1025 ></DIV
1026 ></DIV
1027 ><DIV
1028 CLASS="NAVFOOTER"
1029 ><HR
1030 ALIGN="LEFT"
1031 WIDTH="100%"><TABLE
1032 SUMMARY="Footer navigation table"
1033 WIDTH="100%"
1034 BORDER="0"
1035 CELLPADDING="0"
1036 CELLSPACING="0"
1037 ><TR
1038 ><TD
1039 WIDTH="33%"
1040 ALIGN="left"
1041 VALIGN="top"
1042 ><A
1043 HREF="introduction.html"
1044 ACCESSKEY="P"
1045 >Prev</A
1046 ></TD
1047 ><TD
1048 WIDTH="34%"
1049 ALIGN="center"
1050 VALIGN="top"
1051 ><A
1052 HREF="index.html"
1053 ACCESSKEY="H"
1054 >Home</A
1055 ></TD
1056 ><TD
1057 WIDTH="33%"
1058 ALIGN="right"
1059 VALIGN="top"
1060 ><A
1061 HREF="whatsnew.html"
1062 ACCESSKEY="N"
1063 >Next</A
1064 ></TD
1065 ></TR
1066 ><TR
1067 ><TD
1068 WIDTH="33%"
1069 ALIGN="left"
1070 VALIGN="top"
1071 >Introduction</TD
1072 ><TD
1073 WIDTH="34%"
1074 ALIGN="center"
1075 VALIGN="top"
1076 >&nbsp;</TD
1077 ><TD
1078 WIDTH="33%"
1079 ALIGN="right"
1080 VALIGN="top"
1081 >What's New in this Release</TD
1082 ></TR
1083 ></TABLE
1084 ></DIV
1085 ></BODY
1086 ></HTML
1087 >