Clarifications on filtering and MIME types. Hardcode 'latest release' on home
[privoxy.git] / doc / webserver / faq / trouble.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >Troubleshooting</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="Miscellaneous"
14 HREF="misc.html"><LINK
15 REL="NEXT"
16 TITLE="Contacting the developers, Bug Reporting and Feature Requests"
17 HREF="contact.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="misc.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="contact.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="TROUBLE">5. Troubleshooting</H1
77 ><DIV
78 CLASS="SECT2"
79 ><H3
80 CLASS="SECT2"
81 ><A
82 NAME="AEN700">5.1. I just upgraded and am getting <SPAN
83 CLASS="QUOTE"
84 >"connection refused"</SPAN
85 >
86 with every web page?</H3
87 ><P
88 > Either <SPAN
89 CLASS="APPLICATION"
90 >Privoxy</SPAN
91 > is not running, or your 
92  browser is configured for a different port than what
93  <SPAN
94 CLASS="APPLICATION"
95 >Privoxy</SPAN
96 > is using.</P
97 ><P
98 > The old <SPAN
99 CLASS="APPLICATION"
100 >Privoxy</SPAN
101 > (and also
102  <SPAN
103 CLASS="APPLICATION"
104 >Junkbuster</SPAN
105 >) used port 8000 by 
106  default. This has been changed to port 8118 now, due to a conflict 
107  with NAS (Network Audio Service), which uses port 8000. If you haven't, 
108  you need to change your browser to the new port number, or alternately 
109  change the <A
110 HREF="../user-manual/config.html#LISTEN-ADDRESS"
111 TARGET="_top"
112 ><TT
113 CLASS="LITERAL"
114 >listen-address</TT
115 >
116  option</A
117 > in <SPAN
118 CLASS="APPLICATION"
119 >Privoxy's</SPAN
120 > <A
121 HREF="../user-manual/config.html"
122 TARGET="_top"
123 >main configuration file</A
124 >.</P
125 ></DIV
126 ><DIV
127 CLASS="SECT2"
128 ><H3
129 CLASS="SECT2"
130 ><A
131 NAME="AEN713">5.2. I just added a new rule, but the steenkin ad is 
132 still getting through. How?</H3
133 ><P
134 > If the ad had been displayed before you added its URL, it will probably be
135  held in the browser's cache for some time, so it will be displayed without
136  the need for any request to the server, and <SPAN
137 CLASS="APPLICATION"
138 >Privoxy</SPAN
139 >
140  will not be in the picture. The best thing to do is try flushing the browser's
141  caches. And then try again.</P
142 ><P
143 > If this doesn't help, you probably have an error in the rule you
144  applied. Try pasting the full URL of the offending ad into <A
145 HREF="http://config.privoxy.org/show-url-info"
146 TARGET="_top"
147 >http://config.privoxy.org/show-url-info</A
148 >
149  and see if it really matches your new rule.</P
150 ></DIV
151 ><DIV
152 CLASS="SECT2"
153 ><H3
154 CLASS="SECT2"
155 ><A
156 NAME="AEN719">5.3. One of my favorite sites does not work with <SPAN
157 CLASS="APPLICATION"
158 >Privoxy</SPAN
159 >.
160 What can I do?</H3
161 ><P
162 > First verify that it is indeed a <SPAN
163 CLASS="APPLICATION"
164 >Privoxy</SPAN
165 > problem, 
166  by toggling off <SPAN
167 CLASS="APPLICATION"
168 >Privoxy</SPAN
169 > through <A
170 HREF="http://config.privoxy.org/toggle"
171 TARGET="_top"
172 >http://config.privoxy.org/toggle</A
173 >,
174  and then shift-reloading the problem page (i.e. holding down the shift key
175  while clicking reload. Alternatively, flush your browser's disk and memory
176  caches).</P
177 ><P
178 > If still a problem, go to <A
179 HREF="http://config.privoxy.org/show-url-info"
180 TARGET="_top"
181 >http://config.privoxy.org/show-url-info</A
182 >
183  and paste the full URL of the page in question into the prompt. See which actions
184  are being applied to the URL, and which matches in which actions files are
185  responsible for that. Now, armed with this information, go to <A
186 HREF="http://config.privoxy.org/show-status"
187 TARGET="_top"
188 >http://config.privoxy.org/show-status</A
189 >
190  and select the appropriate actions files for editing.</P
191 ><P
192 > You can now either look for a section which disables the actions that
193  you suspect to cause the problem and add a pattern for your site there,
194  or make up a completely new section for your site. In any case, the recommended
195  way is to disable only the prime suspect, reload the problem page, and only
196  if the problem persists, disable more and more actions until you have
197  identified the culprit. You may or may not want to turn the other actions
198  on again. Remember to flush your browser's caches in between any such changes!</P
199 ><P
200 > Alternately, if you are comfortable with a text editor, you can accomplish 
201  the same thing by editing the appropriate actions file. Probably the easiest 
202  way to deal with such problems when editing by hand is to add your
203  site to a <TT
204 CLASS="LITERAL"
205 >{ fragile }</TT
206 > section in <TT
207 CLASS="FILENAME"
208 >user.action</TT
209 >,
210  which is an alias that turns off most <SPAN
211 CLASS="QUOTE"
212 >"dangerous"</SPAN
213 >
214  actions, but is also likely to turn off more actions then needed, and thus lower
215  your privacy and protection more than necessary, </P
216 ><P
217 > Troubleshooting actions is discussed in more detail in the <A
218 HREF="../user-manual/appendix.html#ACTIONSANAT"
219 TARGET="_top"
220 >user-manual appendix</A
221 >.
222  There is also an <A
223 HREF="../user-manual/actions-file.html#ACT-EXAMPLES"
224 TARGET="_top"
225 >actions tutorial</A
226 >.</P
227 ></DIV
228 ><DIV
229 CLASS="SECT2"
230 ><H2
231 CLASS="SECT2"
232 ><A
233 NAME="DUN">5.4. After installing <SPAN
234 CLASS="APPLICATION"
235 >Privoxy</SPAN
236 >, I have to log in
237 every time I start IE. What gives?</H2
238 ><P
239 > This is a quirk that effects the installation of
240  <SPAN
241 CLASS="APPLICATION"
242 >Privoxy</SPAN
243 >, in conjunction with Internet Explorer and
244  Internet Connection Sharing on Windows 2000 and Windows XP. The symptoms may
245  appear to be corrupted or invalid DUN settings, or passwords.</P
246 ><P
247 > When setting up an NT based Windows system with
248  <SPAN
249 CLASS="APPLICATION"
250 >Privoxy</SPAN
251 > you may find that things do not seem to be
252  doing what you expect. When you set your system up you will probably have set
253  up Internet Connection Sharing (ICS) with Dial up Networking (DUN) when
254  logged in with administrator privileges. You will probably have made this DUN
255  connection available to other accounts that you may have set-up on your
256  system. E.g. Mum or Dad sets up the system and makes accounts suitably
257  configured for the kids.</P
258 ><P
259 > When setting up <SPAN
260 CLASS="APPLICATION"
261 >Privoxy</SPAN
262 > in this environment you
263  will have to alter the proxy set-up of Internet Explorer (IE) for the
264  specific DUN connection on which you wish to use
265  <SPAN
266 CLASS="APPLICATION"
267 >Privoxy</SPAN
268 >. When you do this the ICS DUN set-up
269  becomes user specific. In this instance you will see no difference if you
270  change the DUN connection under the account used to set-up the connection.
271  However when you do this from another user you will notice that the DUN
272  connection changes to make available to "Me only". You will also find that
273  you have to store the password under each different user!</P
274 ><P
275 > The reason for this is that each user's set-up for IE is user specific. Each
276  set-up DUN connection and each LAN connection in IE store the settings for
277  each user individually. As such this enforces individual configurations
278  rather than common ones. Hence the first time you use a DUN connection after
279  re-booting your system it may not perform as you expect, and prompt you for 
280  the password. Just set and save the password again and all should be OK.</P
281 ><P
282 >[Thanks to Ray Griffith for this submission.]</P
283 ></DIV
284 ></DIV
285 ><DIV
286 CLASS="NAVFOOTER"
287 ><HR
288 ALIGN="LEFT"
289 WIDTH="100%"><TABLE
290 SUMMARY="Footer navigation table"
291 WIDTH="100%"
292 BORDER="0"
293 CELLPADDING="0"
294 CELLSPACING="0"
295 ><TR
296 ><TD
297 WIDTH="33%"
298 ALIGN="left"
299 VALIGN="top"
300 ><A
301 HREF="misc.html"
302 ACCESSKEY="P"
303 >Prev</A
304 ></TD
305 ><TD
306 WIDTH="34%"
307 ALIGN="center"
308 VALIGN="top"
309 ><A
310 HREF="index.html"
311 ACCESSKEY="H"
312 >Home</A
313 ></TD
314 ><TD
315 WIDTH="33%"
316 ALIGN="right"
317 VALIGN="top"
318 ><A
319 HREF="contact.html"
320 ACCESSKEY="N"
321 >Next</A
322 ></TD
323 ></TR
324 ><TR
325 ><TD
326 WIDTH="33%"
327 ALIGN="left"
328 VALIGN="top"
329 >Miscellaneous</TD
330 ><TD
331 WIDTH="34%"
332 ALIGN="center"
333 VALIGN="top"
334 >&nbsp;</TD
335 ><TD
336 WIDTH="33%"
337 ALIGN="right"
338 VALIGN="top"
339 >Contacting the developers, Bug Reporting and Feature Requests</TD
340 ></TR
341 ></TABLE
342 ></DIV
343 ></BODY
344 ></HTML
345 >