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.64
   8 "><LINK
   9 REL="HOME"
  10 TITLE="Privoxy User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Introduction"
  14 HREF="introduction.html"><LINK
  15 REL="NEXT"
  16 TITLE="Note to Upgraders"
  17 HREF="upgradersnote.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"></HEAD
  21 ><BODY
  22 CLASS="SECT1"
  23 BGCOLOR="#EEEEEE"
  24 TEXT="#000000"
  25 LINK="#0000FF"
  26 VLINK="#840084"
  27 ALINK="#0000FF"
  28 ><DIV
  29 CLASS="NAVHEADER"
  30 ><TABLE
  31 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 >Privoxy User Manual</TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="introduction.html"
  48 >Prev</A
  49 ></TD
  50 ><TD
  51 WIDTH="80%"
  52 ALIGN="center"
  53 VALIGN="bottom"
  54 ></TD
  55 ><TD
  56 WIDTH="10%"
  57 ALIGN="right"
  58 VALIGN="bottom"
  59 ><A
  60 HREF="upgradersnote.html"
  61 >Next</A
  62 ></TD
  63 ></TR
  64 ></TABLE
  65 ><HR
  66 ALIGN="LEFT"
  67 WIDTH="100%"></DIV
  68 ><DIV
  69 CLASS="SECT1"
  70 ><H1
  71 CLASS="SECT1"
  72 ><A
  73 NAME="INSTALLATION"
  74 >3. Installation</A
  75 ></H1
  76 ><P
  77 > <SPAN
  78 CLASS="APPLICATION"
  79 >Privoxy</SPAN
  80 > is available both in convenient pre-compiled
  81  packages for a wide range of operating systems, and as raw source code.
  82  For most users, we recommend using the packages, which can be downloaded from our
  83  <A
  84 HREF="http://sourceforge.net/projects/ijbswa/"
  85 TARGET="_top"
  86 >Privoxy Project
  87  Page</A
  88 >. For installing and compiling the source code, please look
  89  into our Developer Manual.</P
  90 ><P
  91 > If you like to live on the bleeding edge and are not afraid of using
  92  possibly unstable development versions, you can check out the up-to-the-minute
  93  version directly from <A
  94 HREF="http://sourceforge.net/cvs/?group_id=11118"
  95 TARGET="_top"
  96 >the
  97  CVS repository</A
  98 > or simply download <A
  99 HREF="http://cvs.sourceforge.net/cvstarballs/ijbswa-cvsroot.tar.gz"
 100 TARGET="_top"
 101 >the nightly CVS
 102  tarball.</A
 103 > Again, we refer you to the Developer Manual.</P
 104 ><P
 105 > At present, <SPAN
 106 CLASS="APPLICATION"
 107 >Privoxy</SPAN
 108 > is known to run on
 109  Windows(95, 98, ME, 2000, XP), Linux (RedHat, Suse, Debian), Mac OSX,
 110  OS/2, AmigaOS, FreeBSD, NetBSD, BeOS, and many more flavors of Unix.</P
 111 ><P
 112 > Note: If you have a previous <SPAN
 113 CLASS="APPLICATION"
 114 >Junkbuster</SPAN
 115 > or
 116  <SPAN
 117 CLASS="APPLICATION"
 118 >Privoxy</SPAN
 119 > installation on your system, you
 120  will need to remove it.  Some platforms do this for you as part
 121  of their installation procedure. (See below for your platform).</P
 122 ><P
 123 > In any case <I
 124 CLASS="EMPHASIS"
 125 >be sure to backup your old configuration
 126  if it is valuable to you.</I
 127 > See the
 128  <A
 129 HREF="upgradersnote.html"
 130 >note to upgraders</A
 131 > section
 132  below.</P
 133 ><DIV
 134 CLASS="SECT2"
 135 ><H2
 136 CLASS="SECT2"
 137 ><A
 138 NAME="INSTALLATION-PACK-RPM"
 139 >3.1. Red Hat and SuSE RPMs</A
 140 ></H2
 141 ><P
 142 > RPMs can be installed with <TT
 143 CLASS="LITERAL"
 144 >rpm -Uvh privoxy-2.9.14-1.rpm</TT
 145 >,
 146  and will use <TT
 147 CLASS="FILENAME"
 148 >/etc/privoxy</TT
 149 > for the location
 150  of configuration files.</P
 151 ><P
 152 > Note that on Red Hat, <SPAN
 153 CLASS="APPLICATION"
 154 >Privoxy</SPAN
 155 > will
 156  <I
 157 CLASS="EMPHASIS"
 158 >not</I
 159 > be automatically started on system boot. You will
 160  need to enable that using <B
 161 CLASS="COMMAND"
 162 >chkconfig</B
 163 >,
 164  <B
 165 CLASS="COMMAND"
 166 >ntsysv</B
 167 >, or similar methods. Note that SuSE will
 168 automatically start Privoxy in the boot process.</P
 169 ><P
 170 > If you have problems with failed dependencies, try rebuilding the SRC RPM:
 171  <TT
 172 CLASS="LITERAL"
 173 >rpm --rebuild privoxy-2.9.14-1.src.rpm;</TT
 174 >. This
 175  will use your locally installed libraries and RPM version. </P
 176 ><P
 177 > Also note that if you have a <SPAN
 178 CLASS="APPLICATION"
 179 >Junkbuster</SPAN
 180 > RPM installed
 181  on your system, you need to remove it first, because the packages conflict.
 182  Otherwise, RPM will try to remove <SPAN
 183 CLASS="APPLICATION"
 184 >Junkbuster</SPAN
 185 >
 186  automatically, before installing <SPAN
 187 CLASS="APPLICATION"
 188 >Privoxy</SPAN
 189 >.</P
 190 ></DIV
 191 ><DIV
 192 CLASS="SECT2"
 193 ><H2
 194 CLASS="SECT2"
 195 ><A
 196 NAME="INSTALLATION-DEB"
 197 >3.2. Debian</A
 198 ></H2
 199 ><P
 200 > FIXME.</P
 201 ></DIV
 202 ><DIV
 203 CLASS="SECT2"
 204 ><H2
 205 CLASS="SECT2"
 206 ><A
 207 NAME="INSTALLATION-PACK-WIN"
 208 >3.3. Windows</A
 209 ></H2
 210 ><P
 211 > Just double-click the installer, which will guide you through
 212  the installation process. You will find the configuration files
 213  in the same directory as you installed Privoxy in. We do not
 214  use the registry of Windows. </P
 215 ></DIV
 216 ><DIV
 217 CLASS="SECT2"
 218 ><H2
 219 CLASS="SECT2"
 220 ><A
 221 NAME="INSTALLATION-PACK-BINTGZ"
 222 >3.4. Solaris, NetBSD, FreeBSD, HP-UX</A
 223 ></H2
 224 ><P
 225 > Create a new directory, <TT
 226 CLASS="LITERAL"
 227 >cd</TT
 228 > to it, then unzip and
 229  untar the archive. For the most part, you'll have to figure out where
 230  things go. FIXME.</P
 231 ></DIV
 232 ><DIV
 233 CLASS="SECT2"
 234 ><H2
 235 CLASS="SECT2"
 236 ><A
 237 NAME="INSTALLATION-OS2"
 238 >3.5. OS/2</A
 239 ></H2
 240 ><P
 241 > First, make sure that no previous installations of
 242  <SPAN
 243 CLASS="APPLICATION"
 244 >Junkbuster</SPAN
 245 > and / or
 246  <SPAN
 247 CLASS="APPLICATION"
 248 >Privoxy</SPAN
 249 > are left on your
 250  system. You can do this by </P
 251 ><P
 252 > Then, just double-click the WarpIN self-installing archive, which will
 253  guide you through the installation process. A shadow of the
 254  <SPAN
 255 CLASS="APPLICATION"
 256 >Privoxy</SPAN
 257 > executable will be placed in your
 258  startup folder so it will start automatically whenever OS/2 starts.</P
 259 ><P
 260 > The directory you choose to install <SPAN
 261 CLASS="APPLICATION"
 262 >Privoxy</SPAN
 263 >
 264  into will contain all of the configuration files.</P
 265 ></DIV
 266 ><DIV
 267 CLASS="SECT2"
 268 ><H2
 269 CLASS="SECT2"
 270 ><A
 271 NAME="INSTALLATION-MAC"
 272 >3.6. Max OSX</A
 273 ></H2
 274 ><P
 275 > Unzip the downloaded package (you can either double-click on the file
 276  in the finder, or on the desktop if you downloaded it there).  Then,
 277  double-click on the package installer icon and follow the installation
 278  process.
 279  <SPAN
 280 CLASS="APPLICATION"
 281 >Privoxy</SPAN
 282 > will be installed in the subdirectory
 283  <TT
 284 CLASS="LITERAL"
 285 >/Applications/Privoxy.app</TT
 286 >.
 287  <SPAN
 288 CLASS="APPLICATION"
 289 >Privoxy</SPAN
 290 > will set itself up to start
 291  automatically on system bring-up via
 292  <TT
 293 CLASS="LITERAL"
 294 >/System/Library/StartupItems/Privoxy</TT
 295 >.</P
 296 ></DIV
 297 ><DIV
 298 CLASS="SECT2"
 299 ><H2
 300 CLASS="SECT2"
 301 ><A
 302 NAME="INSTALLATION-AMIGA"
 303 >3.7. AmigaOS</A
 304 ></H2
 305 ><P
 306 > Copy and then unpack the <TT
 307 CLASS="FILENAME"
 308 >lha</TT
 309 > archive to a suitable location.
 310  All necessary files will be installed into <SPAN
 311 CLASS="APPLICATION"
 312 >Privoxy</SPAN
 313 >
 314  directory, including all configuration and log files. To uninstall, just
 315  remove this directory.</P
 316 ><P
 317 > Start <SPAN
 318 CLASS="APPLICATION"
 319 >Privoxy</SPAN
 320 > (with RUN &#60;&#62;NIL:) in your
 321  <TT
 322 CLASS="FILENAME"
 323 >startnet</TT
 324 > script (AmiTCP), in
 325  <TT
 326 CLASS="FILENAME"
 327 >s:user-startup</TT
 328 > (RoadShow), as startup program in your
 329  startup script (Genesis), or as startup action (Miami and MiamiDx).
 330  <SPAN
 331 CLASS="APPLICATION"
 332 >Privoxy</SPAN
 333 > will automatically quit when you quit your
 334  TCP/IP stack (just ignore the harmless warning your TCP/IP stack may display that
 335  <SPAN
 336 CLASS="APPLICATION"
 337 >Privoxy</SPAN
 338 > is still running).</P
 339 ></DIV
 340 ></DIV
 341 ><DIV
 342 CLASS="NAVFOOTER"
 343 ><HR
 344 ALIGN="LEFT"
 345 WIDTH="100%"><TABLE
 346 WIDTH="100%"
 347 BORDER="0"
 348 CELLPADDING="0"
 349 CELLSPACING="0"
 350 ><TR
 351 ><TD
 352 WIDTH="33%"
 353 ALIGN="left"
 354 VALIGN="top"
 355 ><A
 356 HREF="introduction.html"
 357 >Prev</A
 358 ></TD
 359 ><TD
 360 WIDTH="34%"
 361 ALIGN="center"
 362 VALIGN="top"
 363 ><A
 364 HREF="index.html"
 365 >Home</A
 366 ></TD
 367 ><TD
 368 WIDTH="33%"
 369 ALIGN="right"
 370 VALIGN="top"
 371 ><A
 372 HREF="upgradersnote.html"
 373 >Next</A
 374 ></TD
 375 ></TR
 376 ><TR
 377 ><TD
 378 WIDTH="33%"
 379 ALIGN="left"
 380 VALIGN="top"
 381 >Introduction</TD
 382 ><TD
 383 WIDTH="34%"
 384 ALIGN="center"
 385 VALIGN="top"
 386 >&nbsp;</TD
 387 ><TD
 388 WIDTH="33%"
 389 ALIGN="right"
 390 VALIGN="top"
 391 >Note to Upgraders</TD
 392 ></TR
 393 ></TABLE
 394 ></DIV
 395 ></BODY
 396 ></HTML
 397 >