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