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