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