4 >Privoxy Configuration</TITLE
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.64
10 TITLE="Privoxy User Manual"
11 HREF="index.html"><LINK
13 TITLE="Starting Privoxy"
14 HREF="startup.html"><LINK
16 TITLE="The Main Configuration File"
17 HREF="config.html"><LINK
20 HREF="../p_doc.css"></HEAD
39 >Privoxy User Manual</TH
83 > configuration is stored
84 in text files. These files can be edited with a text editor.
85 Many important aspects of <SPAN
89 also be controlled easily with a web browser.
97 >7.1. Controlling <SPAN
100 > with Your Web Browser</A
106 >'s user interface can be reached through the special
108 HREF="http://config.privoxy.org/"
110 >http://config.privoxy.org/</A
117 which is a built-in page and works without Internet access.
118 You will see the following section: </P
138 HREF="http://config.privoxy.org/show-status"
140 >View & change the current configuration</A
147 HREF="http://config.privoxy.org/show-version"
149 >View the source code version numbers</A
156 HREF="http://config.privoxy.org/show-request"
158 >View the request headers.</A
165 HREF="http://config.privoxy.org/show-url-info"
167 >Look up which actions apply to a URL and why</A
174 HREF="http://config.privoxy.org/toggle"
176 >Toggle Privoxy on or off</A
189 > This should be self-explanatory. Note the first item leads to an editor for the
192 >"actions list"</SPAN
193 >, which is where the ad, banner, cookie,
194 and URL blocking magic is configured as well as other advanced features of
198 >. This is an easy way to adjust various
202 > configuration. The actions
203 file, and other configuration files, are explained in detail below. </P
207 >"Toggle Privoxy On or Off"</SPAN
208 > is handy for sites that might
209 have problems with your current actions and filters. You can in fact use
210 it as a test to see whether it is <SPAN
214 causing the problem or not. <SPAN
218 to run as a proxy in this case, but all filtering is disabled. There
220 HREF="appendix.html#BOOKMARKLETS"
223 that you can toggle <SPAN
226 > with one click from
235 >7.2. Configuration Files Overview</A
238 > For Unix, *BSD and Linux, all configuration files are located in
242 > by default. For MS Windows, OS/2, and
243 AmigaOS these are all in the same directory as the
247 > executable. The name
248 and number of configuration files has changed from previous versions, and is
249 subject to change as development progresses.</P
251 > The installed defaults provide a reasonable starting point, though
252 some settings may be aggressive by some standards. For the time being, the
253 principle configuration files are:</P
260 > The main configuration file is named <A
264 on Linux, Unix, BSD, OS/2, and AmigaOS and <TT
268 on Windows. This is a required file.
277 HREF="actions-file.html"
280 the default settings for various <SPAN
283 > relating to images, banners,
284 pop-ups, access restrictions, banners and cookies.
287 > Multiple actions files may be defined in <TT
291 are processed in the order they are defined. Local customizations and locally
292 preferred exceptions to the default policies as defined in
296 > are probably best applied in
300 >, which should be preserved across
304 > is also included. This is mostly
312 There is also a web based editor that can be accessed from
314 HREF="http://config.privoxy.org/show-status/"
316 >http://config.privoxy.org/show-status/</A
319 HREF="http://p.p/show-status/"
321 >http://p.p/show-status/</A
323 various actions files.
332 HREF="filter-file.html"
335 >) can be used to re-write the raw page content, including
336 viewable text as well as embedded HTML and JavaScript, and whatever else
337 lurks on any given web page. The filtering jobs are only pre-defined here;
338 whether to apply them or not is up to the actions files.
344 > All files use the <SPAN
350 > character to denote a
351 comment (the rest of the line will be ignored) angd understand line continuation
352 through placing a backslash ("<TT
355 >") as the very last character
356 in a line. If the <TT
359 > is preceded by a backslash, it looses
360 its special function. Placing a <TT
363 > in front of an otherwise
364 valid configuration line to prevent it from being interpreted is called "commenting
367 > The actions files and <TT
371 can use Perl style <A
372 HREF="appendix.html#REGEX"
373 >regular expressions</A
375 maximum flexibility. </P
377 > After making any changes, there is no need to restart
381 > in order for the changes to take
385 > detects such changes
386 automatically. Note, however, that it may take one or two additional
387 requests for the change to take effect. When changing the listening address
395 must obviously be sent to the <I
398 > listening address.</P
400 > While under development, the configuration content is subject to change.
401 The below documentation may not be accurate by the time you read this.
402 Also, what constitutes a <SPAN
405 > setting, may change, so
406 please check all your configuration files on important issues.</P
462 >The Main Configuration File</TD