generated
[privoxy.git] / 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 >