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.27 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.27 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="https://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-DEB"
 127 >2.1.1. Debian and Ubuntu</A
 128 ></H3
 129 ><P
 130 > DEBs can be installed with <TT
 131 CLASS="LITERAL"
 132 >apt-get install privoxy</TT
 133 >,
 134  and will use <TT
 135 CLASS="FILENAME"
 136 >/etc/privoxy</TT
 137 > for the location of
 138  configuration files.</P
 139 ></DIV
 140 ><DIV
 141 CLASS="SECT3"
 142 ><H3
 143 CLASS="SECT3"
 144 ><A
 145 NAME="INSTALLATION-PACK-WIN"
 146 >2.1.2. Windows</A
 147 ></H3
 148 ><P
 149 > Just double-click the installer, which will guide you through
 150  the installation process. You will find the configuration files
 151  in the same directory as you installed <SPAN
 152 CLASS="APPLICATION"
 153 >Privoxy</SPAN
 154 > in.</P
 155 ><P
 156 > Version 3.0.5 beta introduced full <SPAN
 157 CLASS="APPLICATION"
 158 >Windows</SPAN
 159 > service
 160  functionality. On Windows only, the <SPAN
 161 CLASS="APPLICATION"
 162 >Privoxy</SPAN
 163 >
 164  program has two new command line arguments to install and uninstall
 165  <SPAN
 166 CLASS="APPLICATION"
 167 >Privoxy</SPAN
 168 > as a <SPAN
 169 CLASS="emphasis"
 170 ><I
 171 CLASS="EMPHASIS"
 172 >service</I
 173 ></SPAN
 174 >.</P
 175 ><P
 176 ></P
 177 ><DIV
 178 CLASS="VARIABLELIST"
 179 ><DL
 180 ><DT
 181 >Arguments:</DT
 182 ><DD
 183 ><P
 184 >     <TT
 185 CLASS="REPLACEABLE"
 186 ><I
 187 >--install</I
 188 ></TT
 189 >[:<TT
 190 CLASS="REPLACEABLE"
 191 ><I
 192 >service_name</I
 193 ></TT
 194 >]
 195     </P
 196 ><P
 197 >     <TT
 198 CLASS="REPLACEABLE"
 199 ><I
 200 >--uninstall</I
 201 ></TT
 202 >[:<TT
 203 CLASS="REPLACEABLE"
 204 ><I
 205 >service_name</I
 206 ></TT
 207 >]
 208     </P
 209 ></DD
 210 ></DL
 211 ></DIV
 212 ><P
 213 > After invoking <SPAN
 214 CLASS="APPLICATION"
 215 >Privoxy</SPAN
 216 > with
 217  <B
 218 CLASS="COMMAND"
 219 >--install</B
 220 >, you will need to bring up the
 221  <SPAN
 222 CLASS="APPLICATION"
 223 >Windows</SPAN
 224 > service console to assign the user you
 225  want <SPAN
 226 CLASS="APPLICATION"
 227 >Privoxy</SPAN
 228 > to run under, and whether or not you
 229  want it to run whenever the system starts. You can start the
 230  <SPAN
 231 CLASS="APPLICATION"
 232 >Windows</SPAN
 233 > services console with the following
 234  command: <B
 235 CLASS="COMMAND"
 236 >services.msc</B
 237 >.  If you do not take the manual step
 238  of modifying <SPAN
 239 CLASS="APPLICATION"
 240 >Privoxy's</SPAN
 241 > service settings, it will
 242  not start.  Note too that you will need to give Privoxy a user account that
 243  actually exists, or it will not be permitted to
 244  write to its log and configuration files.</P
 245 ></DIV
 246 ><DIV
 247 CLASS="SECT3"
 248 ><H3
 249 CLASS="SECT3"
 250 ><A
 251 NAME="INSTALLATION-OS2"
 252 >2.1.3. OS/2</A
 253 ></H3
 254 ><P
 255 > First, make sure that no previous installations of
 256  <SPAN
 257 CLASS="APPLICATION"
 258 >Junkbuster</SPAN
 259 > and / or
 260  <SPAN
 261 CLASS="APPLICATION"
 262 >Privoxy</SPAN
 263 > are left on your
 264  system. Check that no <SPAN
 265 CLASS="APPLICATION"
 266 >Junkbuster</SPAN
 267 >
 268  or <SPAN
 269 CLASS="APPLICATION"
 270 >Privoxy</SPAN
 271 > objects are in
 272  your startup folder.</P
 273 ><P
 274 > Then, just double-click the WarpIN self-installing archive, which will
 275  guide you through the installation process. A shadow of the
 276  <SPAN
 277 CLASS="APPLICATION"
 278 >Privoxy</SPAN
 279 > executable will be placed in your
 280  startup folder so it will start automatically whenever OS/2 starts.</P
 281 ><P
 282 > The directory you choose to install <SPAN
 283 CLASS="APPLICATION"
 284 >Privoxy</SPAN
 285 >
 286  into will contain all of the configuration files.</P
 287 ></DIV
 288 ><DIV
 289 CLASS="SECT3"
 290 ><H3
 291 CLASS="SECT3"
 292 ><A
 293 NAME="INSTALLATION-MAC"
 294 >2.1.4. Mac OS X</A
 295 ></H3
 296 ><P
 297 > Installation instructions for the OS X platform depend upon whether
 298  you downloaded a ready-built installation package (.pkg or .mpkg) or have
 299  downloaded the source code.</P
 300 ></DIV
 301 ><DIV
 302 CLASS="SECT3"
 303 ><H4
 304 CLASS="SECT3"
 305 ><A
 306 NAME="OS-X-INSTALL-FROM-PACKAGE"
 307 >2.1.5. Installation from ready-built package</A
 308 ></H4
 309 ><P
 310 > The downloaded file will either be a .pkg (for OS X 10.5 upwards) or a bzipped
 311  .mpkg file (for OS X 10.4). The former can be double-clicked as is and the
 312  installation will start; double-clicking the latter will unzip the .mpkg file
 313  which can then be double-clicked to commence the installation.</P
 314 ><P
 315 > The privoxy service will automatically start after a successful installation
 316  (and thereafter every time your computer starts up) however you will need to
 317  configure your web browser(s) to use it. To do so, configure them to use a
 318  proxy for HTTP and HTTPS at the address 127.0.0.1:8118.</P
 319 ><P
 320 > To prevent the privoxy service from automatically starting when your computer
 321  starts up, remove or rename the file <TT
 322 CLASS="LITERAL"
 323 >/Library/LaunchDaemons/org.ijbswa.privoxy.plist</TT
 324 >
 325  (on OS X 10.5 and higher) or the folder named
 326  <TT
 327 CLASS="LITERAL"
 328 >/Library/StartupItems/Privoxy</TT
 329 > (on OS X 10.4 'Tiger').</P
 330 ><P
 331 > To manually start or stop the privoxy service, use the scripts startPrivoxy.sh
 332  and stopPrivoxy.sh supplied in /Applications/Privoxy. They must be run from an
 333  administrator account, using sudo.</P
 334 ><P
 335 > To uninstall, run /Applications/Privoxy/uninstall.command as sudo from an
 336  administrator account.</P
 337 ></DIV
 338 ><DIV
 339 CLASS="SECT3"
 340 ><H4
 341 CLASS="SECT3"
 342 ><A
 343 NAME="OS-X-INSTALL-FROM-SOURCE"
 344 >2.1.6. Installation from source</A
 345 ></H4
 346 ><P
 347 > To build and install the Privoxy source code on OS X you will need to obtain
 348  the macsetup module from the Privoxy Sourceforge CVS repository (refer to
 349  Sourceforge help for details of how to set up a CVS client to have read-only
 350  access to the repository). This module contains scripts that leverage the usual
 351  open-source tools (available as part of Apple's free of charge Xcode
 352  distribution or via the usual open-source software package managers for OS X
 353  (MacPorts, Homebrew, Fink etc.) to build and then install the privoxy binary
 354  and associated files. The macsetup module's README file contains complete
 355  instructions for its use.</P
 356 ><P
 357 > The privoxy service will automatically start after a successful installation
 358  (and thereafter every time your computer starts up) however you will need to
 359  configure your web browser(s) to use it. To do so, configure them to use a
 360  proxy for HTTP and HTTPS at the address 127.0.0.1:8118.</P
 361 ><P
 362 > To prevent the privoxy service from automatically starting when your computer
 363  starts up, remove or rename the file <TT
 364 CLASS="LITERAL"
 365 >/Library/LaunchDaemons/org.ijbswa.privoxy.plist</TT
 366 >
 367  (on OS X 10.5 and higher) or the folder named
 368  <TT
 369 CLASS="LITERAL"
 370 >/Library/StartupItems/Privoxy</TT
 371 > (on OS X 10.4 'Tiger').</P
 372 ><P
 373 > To manually start or stop the privoxy service, use the Privoxy Utility
 374  for Mac OS X (also part of the macsetup module).  This application can start
 375  and stop the privoxy service and display its log and configuration files.</P
 376 ><P
 377 > To uninstall, run the macsetup module's uninstall.sh as sudo from an
 378  administrator account.</P
 379 ></DIV
 380 ><DIV
 381 CLASS="SECT3"
 382 ><H3
 383 CLASS="SECT3"
 384 ><A
 385 NAME="INSTALLATION-FREEBSD"
 386 >2.1.7. FreeBSD</A
 387 ></H3
 388 ><P
 389 > Privoxy is part of FreeBSD's Ports Collection, you can build and install
 390  it with <TT
 391 CLASS="LITERAL"
 392 >cd /usr/ports/www/privoxy; make install clean</TT
 393 >.</P
 394 ></DIV
 395 ></DIV
 396 ><DIV
 397 CLASS="SECT2"
 398 ><H2
 399 CLASS="SECT2"
 400 ><A
 401 NAME="INSTALLATION-SOURCE"
 402 >2.2. Building from Source</A
 403 ></H2
 404 ><P
 405 > The most convenient way to obtain the <SPAN
 406 CLASS="APPLICATION"
 407 >Privoxy</SPAN
 408 > sources
 409  is to download the source tarball from our
 410  <A
 411 HREF="https://sourceforge.net/projects/ijbswa/files/Sources/"
 412 TARGET="_top"
 413 >project download
 414  page</A
 415 >.</P
 416 ><P
 417 > If you like to live on the bleeding edge and are not afraid of using
 418  possibly unstable development versions, you can check out the up-to-the-minute
 419  version directly from <A
 420 HREF="https://sourceforge.net/p/ijbswa/code/?source=navbar"
 421 TARGET="_top"
 422 >the
 423  CVS repository</A
 424 >.</P
 425 ><P
 426 > To build <SPAN
 427 CLASS="APPLICATION"
 428 >Privoxy</SPAN
 429 > from source,
 430  <A
 431 HREF="http://www.gnu.org/software/autoconf/autoconf.html"
 432 TARGET="_top"
 433 >autoconf</A
 434 >,
 435  <A
 436 HREF="http://www.gnu.org/software/make/make.html"
 437 TARGET="_top"
 438 >GNU make
 439  (gmake)</A
 440 >, and, of course, a C compiler like <A
 441 HREF="http://www.gnu.org/software/gcc/gcc.html"
 442 TARGET="_top"
 443 >gcc</A
 444 > are required.</P
 445 ><P
 446 > When building from a source tarball,
 447  first unpack the source:</P
 448 ><TABLE
 449 BORDER="0"
 450 BGCOLOR="#E0E0E0"
 451 WIDTH="100%"
 452 ><TR
 453 ><TD
 454 ><PRE
 455 CLASS="SCREEN"
 456 > tar xzvf privoxy-3.0.27-beta-src.tar.gz
 457  cd privoxy-3.0.27-beta</PRE
 458 ></TD
 459 ></TR
 460 ></TABLE
 461 ><P
 462 > For retrieving the current CVS sources, you'll need a CVS client installed.
 463  Note that sources from CVS are typically development quality, and may not be
 464  stable, or well tested. To download CVS source, check the Sourceforge
 465  documentation, which might give commands like:</P
 466 ><TABLE
 467 BORDER="0"
 468 BGCOLOR="#E0E0E0"
 469 WIDTH="100%"
 470 ><TR
 471 ><TD
 472 ><PRE
 473 CLASS="SCREEN"
 474 >  cvs -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa login
 475   cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co current
 476   cd current</PRE
 477 ></TD
 478 ></TR
 479 ></TABLE
 480 ><P
 481 > This will create a directory named <TT
 482 CLASS="FILENAME"
 483 >current/</TT
 484 >, which will
 485  contain the source tree.</P
 486 ><P
 487 > You can also check out any <SPAN
 488 CLASS="APPLICATION"
 489 >Privoxy</SPAN
 490 >
 491  <SPAN
 492 CLASS="QUOTE"
 493 >"branch"</SPAN
 494 >, just exchange the <SPAN
 495 CLASS="APPLICATION"
 496 >current</SPAN
 497 >
 498  name with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs
 499  tree).</P
 500 ><P
 501 > It is also strongly recommended to not run <SPAN
 502 CLASS="APPLICATION"
 503 >Privoxy</SPAN
 504 >
 505  as root. You should configure/install/run <SPAN
 506 CLASS="APPLICATION"
 507 >Privoxy</SPAN
 508 > as
 509  an unprivileged user, preferably by  creating a <SPAN
 510 CLASS="QUOTE"
 511 >"privoxy"</SPAN
 512 > user
 513  and group just for this purpose. See your local documentation for the correct
 514  command line to do add new users and groups (something like
 515  <B
 516 CLASS="COMMAND"
 517 >adduser</B
 518 >, but the command syntax may vary from platform
 519  to platform).</P
 520 ><P
 521 > <TT
 522 CLASS="FILENAME"
 523 >/etc/passwd</TT
 524 > might then look like:</P
 525 ><TABLE
 526 BORDER="0"
 527 BGCOLOR="#E0E0E0"
 528 WIDTH="100%"
 529 ><TR
 530 ><TD
 531 ><PRE
 532 CLASS="SCREEN"
 533 >  privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell</PRE
 534 ></TD
 535 ></TR
 536 ></TABLE
 537 ><P
 538 > And then <TT
 539 CLASS="FILENAME"
 540 >/etc/group</TT
 541 >, like:</P
 542 ><TABLE
 543 BORDER="0"
 544 BGCOLOR="#E0E0E0"
 545 WIDTH="100%"
 546 ><TR
 547 ><TD
 548 ><PRE
 549 CLASS="SCREEN"
 550 >  privoxy:*:7777:</PRE
 551 ></TD
 552 ></TR
 553 ></TABLE
 554 ><P
 555 > Some binary packages may do this for you.</P
 556 ><P
 557 > Then, to build from either unpacked tarball or CVS source:</P
 558 ><TABLE
 559 BORDER="0"
 560 BGCOLOR="#E0E0E0"
 561 WIDTH="100%"
 562 ><TR
 563 ><TD
 564 ><PRE
 565 CLASS="SCREEN"
 566 > autoheader
 567  autoconf
 568  ./configure      # (--help to see options)
 569  make             # (the make from GNU, sometimes called gmake)
 570  su               # Possibly required
 571  make -n install  # (to see where all the files will go)
 572  make -s install  # (to really install, -s to silence output)</PRE
 573 ></TD
 574 ></TR
 575 ></TABLE
 576 ><P
 577 >  Using GNU <B
 578 CLASS="COMMAND"
 579 >make</B
 580 >, you can have the first four steps
 581   automatically done for you by just typing:</P
 582 ><TABLE
 583 BORDER="0"
 584 BGCOLOR="#E0E0E0"
 585 WIDTH="100%"
 586 ><TR
 587 ><TD
 588 ><PRE
 589 CLASS="SCREEN"
 590 >  make</PRE
 591 ></TD
 592 ></TR
 593 ></TABLE
 594 ><P
 595 >  in the freshly downloaded or unpacked source directory.</P
 596 ><P
 597 > To build an executable with security enhanced features so that
 598  users cannot easily bypass the proxy (e.g. <SPAN
 599 CLASS="QUOTE"
 600 >"Go There Anyway"</SPAN
 601 >), or
 602  alter their own configurations, <B
 603 CLASS="COMMAND"
 604 >configure</B
 605 > like this:</P
 606 ><TABLE
 607 BORDER="0"
 608 BGCOLOR="#E0E0E0"
 609 WIDTH="100%"
 610 ><TR
 611 ><TD
 612 ><PRE
 613 CLASS="SCREEN"
 614 > ./configure  --disable-toggle  --disable-editor  --disable-force</PRE
 615 ></TD
 616 ></TR
 617 ></TABLE
 618 ><P
 619 > Note that all of these options can also be disabled through the configuration file.</P
 620 ><P
 621 > <SPAN
 622 CLASS="emphasis"
 623 ><I
 624 CLASS="EMPHASIS"
 625 >WARNING:</I
 626 ></SPAN
 627 > If installing as root, the install will fail
 628  unless a non-root user or group is specified, or a <TT
 629 CLASS="LITERAL"
 630 >privoxy</TT
 631 >
 632  user and group already exist on the system. If a non-root user is specified,
 633  and no group, then the installation will try to also use a group of the same name
 634  as <SPAN
 635 CLASS="QUOTE"
 636 >"user"</SPAN
 637 >. If a group is specified (and no user), then the
 638  support files will be installed as writable by that group, and owned by the
 639  user running the installation.</P
 640 ><P
 641 > <B
 642 CLASS="COMMAND"
 643 >configure</B
 644 > accepts <TT
 645 CLASS="LITERAL"
 646 >--with-user</TT
 647 > and
 648  <TT
 649 CLASS="LITERAL"
 650 >--with-group</TT
 651 > options for setting user and group ownership
 652  of the configuration files (which need to be writable by the daemon). The
 653  specified <SPAN
 654 CLASS="emphasis"
 655 ><I
 656 CLASS="EMPHASIS"
 657 >user must already exist</I
 658 ></SPAN
 659 >. When starting
 660  <SPAN
 661 CLASS="APPLICATION"
 662 >Privoxy</SPAN
 663 >, it must be run as this same user to
 664  insure write access to configuration and log files!</P
 665 ><P
 666 > Alternately, you can specify <TT
 667 CLASS="LITERAL"
 668 >user</TT
 669 > and <TT
 670 CLASS="LITERAL"
 671 >group</TT
 672 >
 673  on the <B
 674 CLASS="COMMAND"
 675 >make</B
 676 > command line, but be sure both already exist:</P
 677 ><TABLE
 678 BORDER="0"
 679 BGCOLOR="#E0E0E0"
 680 WIDTH="100%"
 681 ><TR
 682 ><TD
 683 ><PRE
 684 CLASS="SCREEN"
 685 > make -s install  USER=privoxy GROUP=privoxy</PRE
 686 ></TD
 687 ></TR
 688 ></TABLE
 689 ><P
 690 > The default installation path for <B
 691 CLASS="COMMAND"
 692 >make install</B
 693 > is
 694  <TT
 695 CLASS="FILENAME"
 696 >/usr/local</TT
 697 >. This may of course be customized with
 698  the various <B
 699 CLASS="COMMAND"
 700 >./configure</B
 701 > path options. If you are doing
 702  an install to anywhere besides <TT
 703 CLASS="FILENAME"
 704 >/usr/local</TT
 705 >, be
 706  sure to set the appropriate paths with the correct configure options
 707  (<B
 708 CLASS="COMMAND"
 709 >./configure --help</B
 710 >). Non-privileged users must of course
 711  have write access permissions to wherever the target installation is going.</P
 712 ><P
 713 > If you do install to <TT
 714 CLASS="FILENAME"
 715 >/usr/local</TT
 716 >, the install will use
 717  <TT
 718 CLASS="LITERAL"
 719 >sysconfdir=$prefix/etc/privoxy</TT
 720 > by default. All other
 721  destinations, and the direct usage of <TT
 722 CLASS="LITERAL"
 723 >--sysconfdir</TT
 724 > flag
 725  behave like normal, i.e. will not add the extra <TT
 726 CLASS="FILENAME"
 727 >privoxy</TT
 728 >
 729  directory. This is for a safer install, as there may already exist another
 730  program that uses a file with the <SPAN
 731 CLASS="QUOTE"
 732 >"config"</SPAN
 733 > name, and thus makes
 734  <TT
 735 CLASS="FILENAME"
 736 >/usr/local/etc</TT
 737 > cleaner.</P
 738 ><P
 739 > If installing to <TT
 740 CLASS="FILENAME"
 741 >/usr/local</TT
 742 >, the documentation will go
 743  by default to <TT
 744 CLASS="FILENAME"
 745 >$prefix/share/doc</TT
 746 >. But if this directory
 747  doesn't exist, it will then try <TT
 748 CLASS="FILENAME"
 749 >$prefix/doc</TT
 750 > and install
 751  there before creating a new <TT
 752 CLASS="FILENAME"
 753 >$prefix/share/doc</TT
 754 > just for
 755  <SPAN
 756 CLASS="APPLICATION"
 757 >Privoxy</SPAN
 758 >.</P
 759 ><P
 760 > Again, if the installs goes to <TT
 761 CLASS="FILENAME"
 762 >/usr/local</TT
 763 >, the
 764  <TT
 765 CLASS="LITERAL"
 766 >localstatedir</TT
 767 > (ie: <TT
 768 CLASS="FILENAME"
 769 >var/</TT
 770 >) will default
 771  to <TT
 772 CLASS="FILENAME"
 773 >/var</TT
 774 > instead of <TT
 775 CLASS="LITERAL"
 776 >$prefix/var</TT
 777 > so
 778  the logs will go to <TT
 779 CLASS="FILENAME"
 780 >/var/log/privoxy/</TT
 781 >, and the pid file
 782  will be created in <TT
 783 CLASS="FILENAME"
 784 >/var/run/privoxy.pid</TT
 785 >.</P
 786 ><P
 787 > <B
 788 CLASS="COMMAND"
 789 >make install</B
 790 > will attempt to set the correct values
 791  in <TT
 792 CLASS="FILENAME"
 793 >config</TT
 794 > (main configuration file). You should
 795  check this to make sure all values are correct. If appropriate,
 796  an init script will be installed, but it is up to the user to determine
 797  how and where to start <SPAN
 798 CLASS="APPLICATION"
 799 >Privoxy</SPAN
 800 >. The init
 801  script should be checked for correct paths and values, if anything other than
 802  a default install is done.</P
 803 ><P
 804 > If install finds previous versions of local configuration files, most of
 805  these will not be overwritten, and the new ones will be installed with a
 806  <SPAN
 807 CLASS="QUOTE"
 808 >"new"</SPAN
 809 > extension. default.action and default.filter
 810  <SPAN
 811 CLASS="emphasis"
 812 ><I
 813 CLASS="EMPHASIS"
 814 >will be overwritten</I
 815 ></SPAN
 816 >. You will then need
 817  to manually update the other installed configuration files as needed. The
 818  default template files <SPAN
 819 CLASS="emphasis"
 820 ><I
 821 CLASS="EMPHASIS"
 822 >will</I
 823 ></SPAN
 824 > be overwritten. If you have
 825  customized, local templates, these should be stored safely in a separate
 826  directory and defined in <TT
 827 CLASS="FILENAME"
 828 >config</TT
 829 > by the
 830  <SPAN
 831 CLASS="QUOTE"
 832 >"templdir"</SPAN
 833 > directive. It is of course wise to always back-up any
 834  important configuration files <SPAN
 835 CLASS="QUOTE"
 836 >"just in case"</SPAN
 837 >. If a previous
 838  version of <SPAN
 839 CLASS="APPLICATION"
 840 >Privoxy</SPAN
 841 > is already running, you will
 842  have to restart it manually.</P
 843 ><P
 844 > For more detailed instructions on how to build Redhat RPMs,
 845  Windows self-extracting installers, building on platforms with
 846  special requirements etc, please consult the <A
 847 HREF="https://www.privoxy.org/developer-manual/newrelease.html"
 848 TARGET="_top"
 849 >developer manual</A
 850 >.</P
 851 ></DIV
 852 ><DIV
 853 CLASS="SECT2"
 854 ><H2
 855 CLASS="SECT2"
 856 ><A
 857 NAME="INSTALLATION-KEEPUPDATED"
 858 >2.3. Keeping your Installation Up-to-Date</A
 859 ></H2
 860 ><P
 861 > If you wish to receive an email notification whenever we release updates of
 862  <SPAN
 863 CLASS="APPLICATION"
 864 >Privoxy</SPAN
 865 > or the actions file, <A
 866 HREF="https://lists.privoxy.org/mailman/listinfo/privoxy-announce"
 867 TARGET="_top"
 868 >subscribe
 869  to our announce mailing list</A
 870 >, privoxy-announce@lists.privoxy.org.</P
 871 ><P
 872 > In order not to lose your personal changes and adjustments when updating
 873  to the latest <TT
 874 CLASS="LITERAL"
 875 >default.action</TT
 876 > file we <SPAN
 877 CLASS="emphasis"
 878 ><I
 879 CLASS="EMPHASIS"
 880 >strongly
 881  recommend</I
 882 ></SPAN
 883 > that you use <TT
 884 CLASS="LITERAL"
 885 >user.action</TT
 886 > and
 887  <TT
 888 CLASS="LITERAL"
 889 >user.filter</TT
 890 > for your local
 891  customizations of <SPAN
 892 CLASS="APPLICATION"
 893 >Privoxy</SPAN
 894 >. See the <A
 895 HREF="actions-file.html"
 896 >Chapter on actions files</A
 897 > for details.</P
 898 ></DIV
 899 ></DIV
 900 ><DIV
 901 CLASS="NAVFOOTER"
 902 ><HR
 903 ALIGN="LEFT"
 904 WIDTH="100%"><TABLE
 905 SUMMARY="Footer navigation table"
 906 WIDTH="100%"
 907 BORDER="0"
 908 CELLPADDING="0"
 909 CELLSPACING="0"
 910 ><TR
 911 ><TD
 912 WIDTH="33%"
 913 ALIGN="left"
 914 VALIGN="top"
 915 ><A
 916 HREF="introduction.html"
 917 ACCESSKEY="P"
 918 >Prev</A
 919 ></TD
 920 ><TD
 921 WIDTH="34%"
 922 ALIGN="center"
 923 VALIGN="top"
 924 ><A
 925 HREF="index.html"
 926 ACCESSKEY="H"
 927 >Home</A
 928 ></TD
 929 ><TD
 930 WIDTH="33%"
 931 ALIGN="right"
 932 VALIGN="top"
 933 ><A
 934 HREF="whatsnew.html"
 935 ACCESSKEY="N"
 936 >Next</A
 937 ></TD
 938 ></TR
 939 ><TR
 940 ><TD
 941 WIDTH="33%"
 942 ALIGN="left"
 943 VALIGN="top"
 944 >Introduction</TD
 945 ><TD
 946 WIDTH="34%"
 947 ALIGN="center"
 948 VALIGN="top"
 949 >&nbsp;</TD
 950 ><TD
 951 WIDTH="33%"
 952 ALIGN="right"
 953 VALIGN="top"
 954 >What's New in this Release</TD
 955 ></TR
 956 ></TABLE
 957 ></DIV
 958 ></BODY
 959 ></HTML
 960 >