41fd896309d7a3a3261a41f6b2715bce95954899
[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.64
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 WIDTH="100%"
32 BORDER="0"
33 CELLPADDING="0"
34 CELLSPACING="0"
35 ><TR
36 ><TH
37 COLSPAN="3"
38 ALIGN="center"
39 >Privoxy Frequently Asked Questions</TH
40 ></TR
41 ><TR
42 ><TD
43 WIDTH="10%"
44 ALIGN="left"
45 VALIGN="bottom"
46 ><A
47 HREF="general.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="configuration.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 >2. Installation</A
75 ></H1
76 ><DIV
77 CLASS="SECT2"
78 ><H3
79 CLASS="SECT2"
80 ><A
81 NAME="WHICHBROWSERS"
82 >2.1. Which browsers are supported by <SPAN
83 CLASS="APPLICATION"
84 >Privoxy</SPAN
85 >?</A
86 ></H3
87 ><P
88 > Any browser that can be configured to use a <SPAN
89 CLASS="QUOTE"
90 >"proxy"</SPAN
91 >, which 
92  should be virtually all browsers. Direct browser support is not necessary
93  since <SPAN
94 CLASS="APPLICATION"
95 >Privoxy</SPAN
96 > runs as a separate application and
97  just exchanges standard HTML data with your browser, just like a web server
98  does.</P
99 ></DIV
100 ><DIV
101 CLASS="SECT2"
102 ><H3
103 CLASS="SECT2"
104 ><A
105 NAME="WHICHOS"
106 >2.2. Which operating systems are supported?</A
107 ></H3
108 ><P
109 > At present, <SPAN
110 CLASS="APPLICATION"
111 >Privoxy</SPAN
112 > is known to run on Win32, Mac
113  OSX, OS/2, AmigaOS, Linux (RedHat, Suse, Debian), FreeBSD, and many flavors
114  of Unix. There are source and binary releases for these available for
115  download at <A
116 HREF="http://sourceforge.net/project/showfiles.php?group_id=11118"
117 TARGET="_top"
118 >http://sourceforge.net/project/showfiles.php?group_id=11118</A
119 >.</P
120 ><P
121 > But any operating system that runs TCP/IP, can conceivably take advantage of
122  <SPAN
123 CLASS="APPLICATION"
124 >Privoxy</SPAN
125 > in a networked situation where
126  <SPAN
127 CLASS="APPLICATION"
128 >Privoxy</SPAN
129 > would run as a server on a LAN gateway. 
130  Then only the <SPAN
131 CLASS="QUOTE"
132 >"gateway"</SPAN
133 > needs to be running one of the above
134  operating systems. </P
135 ><P
136 > Source code is freely available, so porting to other operating systems, 
137  is always a possibility.</P
138 ></DIV
139 ><DIV
140 CLASS="SECT2"
141 ><H3
142 CLASS="SECT2"
143 ><A
144 NAME="NEWINSTALL"
145 >2.3. Can I install  
146  <SPAN
147 CLASS="APPLICATION"
148 >Privoxy</SPAN
149 > over <SPAN
150 CLASS="APPLICATION"
151 >Junkbuster</SPAN
152 >?</A
153 ></H3
154 ><P
155 >   We recommend you uninstall <SPAN
156 CLASS="APPLICATION"
157 >Junkbuster</SPAN
158 >
159    first to minimize conflicts and confusion. You may want to 
160    save your old configuration files for future reference. The configuration
161    is substantially changed.
162  </P
163 ><P
164 >  See the <A
165 HREF="../user-manual/index.html"
166 TARGET="_top"
167 >user-manual</A
168 > for
169   platform specific installation instructions.
170  </P
171 ><P
172 >  Note: Some installers may automatically uninstall
173   <SPAN
174 CLASS="APPLICATION"
175 >Junkbuster</SPAN
176 >, if present!
177  </P
178 ></DIV
179 ><DIV
180 CLASS="SECT2"
181 ><H3
182 CLASS="SECT2"
183 ><A
184 NAME="AEN198"
185 >2.4. I just installed <SPAN
186 CLASS="APPLICATION"
187 >Privoxy</SPAN
188 >. Is there anything 
189 special I have to do now?</A
190 ></H3
191 ><P
192 > All browsers must be told to use <SPAN
193 CLASS="APPLICATION"
194 >Privoxy</SPAN
195
196  as a proxy by specifying the correct proxy address and port number 
197  in the appropriate configuration area for the browser. See below.
198  Also, you should flush your browser's memory and disk cache to get rid of any
199  cached items.&#13;</P
200 ></DIV
201 ><DIV
202 CLASS="SECT2"
203 ><H3
204 CLASS="SECT2"
205 ><A
206 NAME="LOCALHOST"
207 >2.5. What is the proxy address of <SPAN
208 CLASS="APPLICATION"
209 >Privoxy</SPAN
210 >?</A
211 ></H3
212 ><P
213 >  If you set up the <SPAN
214 CLASS="APPLICATION"
215 >Privoxy</SPAN
216 > to run on
217   the computer you browse from (rather than your ISP's server or some
218   networked computer on a LAN), the proxy will be on <SPAN
219 CLASS="QUOTE"
220 >"localhost"</SPAN
221 >
222   (which is the special name used by every computer on the Internet to refer
223   to itself) and the port will be 8118 (unless you have <SPAN
224 CLASS="APPLICATION"
225 >Privoxy</SPAN
226 > to run on a different port with the
227   <I
228 CLASS="EMPHASIS"
229 >listen-address</I
230 > config option). 
231  </P
232 ><P
233 >  When configuring your browser's proxy settings you typically enter
234   the word <SPAN
235 CLASS="QUOTE"
236 >"localhost"</SPAN
237 > in the boxes next to <SPAN
238 CLASS="QUOTE"
239 >"HTTP"</SPAN
240 >
241   and <SPAN
242 CLASS="QUOTE"
243 >"Secure"</SPAN
244 > (HTTPS) and then the number <SPAN
245 CLASS="QUOTE"
246 >"8118"</SPAN
247 >
248   for <SPAN
249 CLASS="QUOTE"
250 >"port"</SPAN
251 >.  This tells your browser to send all web 
252   requests to <SPAN
253 CLASS="APPLICATION"
254 >Privoxy</SPAN
255 > instead of directly to the 
256   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.
270  </P
271 ><P
272 >  <SPAN
273 CLASS="APPLICATION"
274 >Privoxy</SPAN
275 > does not currently handle
276   protocols such as FTP, SMTP, IM, IRC, ICQ, or other Internet
277   protocols. 
278  </P
279 ></DIV
280 ><DIV
281 CLASS="SECT2"
282 ><H3
283 CLASS="SECT2"
284 ><A
285 NAME="AEN223"
286 >2.6. I just installed <SPAN
287 CLASS="APPLICATION"
288 >Privoxy</SPAN
289 >, and nothing is happening.
290 All the ads are there. What's wrong?</A
291 ></H3
292 ><P
293 > Did you configure your browser to use <SPAN
294 CLASS="APPLICATION"
295 >Privoxy</SPAN
296
297  as a proxy? It does not sound like it. See above. You might also try flushing
298  the browser's caches to force a full re-reading of pages. You can verify 
299  that <SPAN
300 CLASS="APPLICATION"
301 >Privoxy</SPAN
302 > is running, and your browser 
303  is correctly configured by entering the special URL: 
304  <A
305 HREF="http://p.p/"
306 TARGET="_top"
307 >http://p.p/</A
308 >. This should give you 
309  a banner that says <SPAN
310 CLASS="QUOTE"
311 >"This is Privoxy"</SPAN
312 > and 
313  access to <SPAN
314 CLASS="APPLICATION"
315 >Privoxy's</SPAN
316 > internal configuration. 
317  If you see this, then you are good to go. If not, the browser or 
318  <SPAN
319 CLASS="APPLICATION"
320 >Privoxy</SPAN
321 > are not set up correctly.&#13;</P
322 ></DIV
323 ></DIV
324 ><DIV
325 CLASS="NAVFOOTER"
326 ><HR
327 ALIGN="LEFT"
328 WIDTH="100%"><TABLE
329 WIDTH="100%"
330 BORDER="0"
331 CELLPADDING="0"
332 CELLSPACING="0"
333 ><TR
334 ><TD
335 WIDTH="33%"
336 ALIGN="left"
337 VALIGN="top"
338 ><A
339 HREF="general.html"
340 >Prev</A
341 ></TD
342 ><TD
343 WIDTH="34%"
344 ALIGN="center"
345 VALIGN="top"
346 ><A
347 HREF="index.html"
348 >Home</A
349 ></TD
350 ><TD
351 WIDTH="33%"
352 ALIGN="right"
353 VALIGN="top"
354 ><A
355 HREF="configuration.html"
356 >Next</A
357 ></TD
358 ></TR
359 ><TR
360 ><TD
361 WIDTH="33%"
362 ALIGN="left"
363 VALIGN="top"
364 >General Information</TD
365 ><TD
366 WIDTH="34%"
367 ALIGN="center"
368 VALIGN="top"
369 >&nbsp;</TD
370 ><TD
371 WIDTH="33%"
372 ALIGN="right"
373 VALIGN="top"
374 >Configuration</TD
375 ></TR
376 ></TABLE
377 ></DIV
378 ></BODY
379 ></HTML
380 >