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