06fff2bf6245e6231fab908345bb011cc6ac2587
[privoxy.git] / doc / webserver / faq / 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 Frequently Asked Questions"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="General Information"
14 HREF="general.html"><LINK
15 REL="NEXT"
16 TITLE="Configuration"
17 HREF="configuration.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 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Privoxy Frequently Asked Questions</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="general.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 ></TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="configuration.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECT1"
73 ><H1
74 CLASS="SECT1"
75 ><A
76 NAME="INSTALLATION">2. Installation</H1
77 ><DIV
78 CLASS="SECT2"
79 ><H3
80 CLASS="SECT2"
81 ><A
82 NAME="WHICHBROWSERS">2.1. Which browsers are supported by <SPAN
83 CLASS="APPLICATION"
84 >Privoxy</SPAN
85 >?</H3
86 ><P
87 > Any browser that can be configured to use a proxy, which 
88  should be virtually all browsers. Direct browser support is not necessary
89  since <SPAN
90 CLASS="APPLICATION"
91 >Privoxy</SPAN
92 > runs as a separate application and
93  talks to the browser in the standardized HTTP protocol, just like a web server
94  does.</P
95 ></DIV
96 ><DIV
97 CLASS="SECT2"
98 ><H3
99 CLASS="SECT2"
100 ><A
101 NAME="WHICHOS">2.2. Which operating systems are supported?</H3
102 ><P
103 > At present, <SPAN
104 CLASS="APPLICATION"
105 >Privoxy</SPAN
106 > is known to run on
107  Windows(95, 98, ME, 2000, XP), Linux (RedHat, SuSE, Debian, Conectiva, Gentoo,
108  Slackware), Mac OSX, OS/2, AmigaOS, BeOS, FreeBSD, NetBSD, Solaris, and more 
109  flavors of Unix.</P
110 ><P
111 > But any operating system that runs TCP/IP, can conceivably take advantage of
112  <SPAN
113 CLASS="APPLICATION"
114 >Privoxy</SPAN
115 > in a networked situation where
116  <SPAN
117 CLASS="APPLICATION"
118 >Privoxy</SPAN
119 > would run as a server on a LAN gateway. 
120  Then only the <SPAN
121 CLASS="QUOTE"
122 >"gateway"</SPAN
123 > needs to be running one of the above
124  operating systems.</P
125 ><P
126 > Source code is freely available, so porting to other operating systems 
127  is always a possibility.</P
128 ></DIV
129 ><DIV
130 CLASS="SECT2"
131 ><H3
132 CLASS="SECT2"
133 ><A
134 NAME="NEWINSTALL">2.3. Can I install  
135  <SPAN
136 CLASS="APPLICATION"
137 >Privoxy</SPAN
138 > over <SPAN
139 CLASS="APPLICATION"
140 >Junkbuster</SPAN
141 >?</H3
142 ><P
143 >   We recommend you un-install <SPAN
144 CLASS="APPLICATION"
145 >Junkbuster</SPAN
146 >
147    first to minimize conflicts and confusion. You may want to 
148    save your old configuration files for future reference. The configuration
149    files and syntax have substantially changed, so you will need to manually
150    port your old patterns. See the <A
151 HREF="../user-manual/upgradersnote.html"
152 TARGET="_top"
153 >note
154    to upgraders</A
155 > and <A
156 HREF="../user-manual/installation.html"
157 TARGET="_top"
158 >installation
159    chapter</A
160 > in the <A
161 HREF="../user-manual/index.html"
162 TARGET="_top"
163 >user manual</A
164 >
165    for details.
166  </P
167 ><P
168 >  Note: Some installers may automatically un-install
169   <SPAN
170 CLASS="APPLICATION"
171 >Junkbuster</SPAN
172 >, if present!
173  </P
174 ></DIV
175 ><DIV
176 CLASS="SECT2"
177 ><H3
178 CLASS="SECT2"
179 ><A
180 NAME="AEN209">2.4. I just installed <SPAN
181 CLASS="APPLICATION"
182 >Privoxy</SPAN
183 >. Is there anything 
184 special I have to do now?</H3
185 ><P
186 > All browsers must be told to use <SPAN
187 CLASS="APPLICATION"
188 >Privoxy</SPAN
189
190  as a proxy by specifying the correct proxy address and port number 
191  in the appropriate configuration area for the browser. See below.
192  You should also flush your browser's memory and disk cache to get rid of any
193  cached junk items.&#13;</P
194 ></DIV
195 ><DIV
196 CLASS="SECT2"
197 ><H3
198 CLASS="SECT2"
199 ><A
200 NAME="LOCALHOST">2.5. What is the proxy address of <SPAN
201 CLASS="APPLICATION"
202 >Privoxy</SPAN
203 >?</H3
204 ><P
205 >  If you set up the <SPAN
206 CLASS="APPLICATION"
207 >Privoxy</SPAN
208 > to run on
209   the computer you browse from (rather than your ISP's server or some
210   networked computer on a LAN), the proxy will be on <TT
211 CLASS="LITERAL"
212 >127.0.0.1</TT
213
214   (sometimes referred to as <SPAN
215 CLASS="QUOTE"
216 >"localhost"</SPAN
217 >,
218   which is the special name used by every computer on the Internet to refer
219   to itself) and the port will be 8118 (unless you have <SPAN
220 CLASS="APPLICATION"
221 >Privoxy</SPAN
222 >
223   to run on a different port with the <A
224 HREF="../user-manual/config.html#LISTEN-ADDRESS"
225 TARGET="_top"
226 >listen-address</A
227 > config option). 
228  </P
229 ><P
230 >  When configuring your browser's proxy settings you typically enter
231   the word <SPAN
232 CLASS="QUOTE"
233 >"localhost"</SPAN
234 > or the IP address <SPAN
235 CLASS="QUOTE"
236 >"127.0.0.1"</SPAN
237 >
238   in the boxes next to <SPAN
239 CLASS="QUOTE"
240 >"HTTP"</SPAN
241 > and <SPAN
242 CLASS="QUOTE"
243 >"Secure"</SPAN
244 > (HTTPS) and
245   then the number <SPAN
246 CLASS="QUOTE"
247 >"8118"</SPAN
248 > for <SPAN
249 CLASS="QUOTE"
250 >"port"</SPAN
251 >. 
252   This tells your browser to send all web requests to <SPAN
253 CLASS="APPLICATION"
254 >Privoxy</SPAN
255 >
256   instead of directly to the Internet.
257  </P
258 ><P
259 >  <SPAN
260 CLASS="APPLICATION"
261 >Privoxy</SPAN
262 > can also be used to proxy for 
263   a Local Area Network. In this case, your would enter either the IP 
264   address of the LAN host where <SPAN
265 CLASS="APPLICATION"
266 >Privoxy</SPAN
267
268   is running, or the equivalent hostname. Port assignment would be 
269   same as above. Note that <SPAN
270 CLASS="APPLICATION"
271 >Privoxy</SPAN
272 > doesn't
273   listen on any LAN interfaces by default.
274  </P
275 ><P
276 >  <SPAN
277 CLASS="APPLICATION"
278 >Privoxy</SPAN
279 > does not currently handle
280   protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
281   protocols. 
282  </P
283 ></DIV
284 ><DIV
285 CLASS="SECT2"
286 ><H3
287 CLASS="SECT2"
288 ><A
289 NAME="NOTHING">2.6. I just installed <SPAN
290 CLASS="APPLICATION"
291 >Privoxy</SPAN
292 >, and nothing is happening.
293 All the ads are there. What's wrong?</H3
294 ><P
295 > Did you configure your browser to use <SPAN
296 CLASS="APPLICATION"
297 >Privoxy</SPAN
298
299  as a proxy? It does not sound like it. See above. You might also try flushing
300  the browser's caches to force a full re-reading of pages. You can verify 
301  that <SPAN
302 CLASS="APPLICATION"
303 >Privoxy</SPAN
304 > is running, and your browser 
305  is correctly configured by entering the special URL: 
306  <A
307 HREF="http://config.privoxy.org/"
308 TARGET="_top"
309 >http://config.privoxy.org/</A
310 >.
311  This should take you to a page titled <SPAN
312 CLASS="QUOTE"
313 >"This is Privoxy.."</SPAN
314 > with
315  access to <SPAN
316 CLASS="APPLICATION"
317 >Privoxy's</SPAN
318 > internal configuration.
319  If you see this, then you are good to go. If you receive a page saying 
320  <SPAN
321 CLASS="QUOTE"
322 >"Privoxy is not running"</SPAN
323 >, then the browser is not set up to use
324  your <SPAN
325 CLASS="APPLICATION"
326 >Privoxy</SPAN
327 > installation.
328  If you receive anything else (probably nothing at all), it could either
329  be that the browser is not set up correctly, or that
330  <SPAN
331 CLASS="APPLICATION"
332 >Privoxy</SPAN
333 > is not running at all. Check the <A
334 HREF="../user-manual/config.html#LOGFILE"
335 TARGET="_top"
336 >log file</A
337 >.</P
338 ></DIV
339 ></DIV
340 ><DIV
341 CLASS="NAVFOOTER"
342 ><HR
343 ALIGN="LEFT"
344 WIDTH="100%"><TABLE
345 SUMMARY="Footer navigation 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="general.html"
357 ACCESSKEY="P"
358 >Prev</A
359 ></TD
360 ><TD
361 WIDTH="34%"
362 ALIGN="center"
363 VALIGN="top"
364 ><A
365 HREF="index.html"
366 ACCESSKEY="H"
367 >Home</A
368 ></TD
369 ><TD
370 WIDTH="33%"
371 ALIGN="right"
372 VALIGN="top"
373 ><A
374 HREF="configuration.html"
375 ACCESSKEY="N"
376 >Next</A
377 ></TD
378 ></TR
379 ><TR
380 ><TD
381 WIDTH="33%"
382 ALIGN="left"
383 VALIGN="top"
384 >General Information</TD
385 ><TD
386 WIDTH="34%"
387 ALIGN="center"
388 VALIGN="top"
389 >&nbsp;</TD
390 ><TD
391 WIDTH="33%"
392 ALIGN="right"
393 VALIGN="top"
394 >Configuration</TD
395 ></TR
396 ></TABLE
397 ></DIV
398 ></BODY
399 ></HTML
400 >