Merge changes from Debian revision 3.0.6-4.
[privoxy.git] / debian / README.Debian
1 privoxy for Debian
2 ==================
3
4 - enable-edit-actions, enable-remote-toggle, and
5   enable-remote-http-toggle are disabled in the Debian package for
6   security reasons, because these options allow every user of your
7   privoxy to change its configuration.  Except this there exist
8   exploits using Java and/or JavaScript that tell your browser to send
9   out requests for disabling the proxy or the filtering, which may
10   compromise your anonymity.  If you still want to use these features,
11   you can enable them in /etc/privoxy/config and do a
12   "/etc/init.d/privoxy restart".
13
14 - Comment "debug 1" from default configuration, so GET/POST/CONNECT
15   requests are no longer logged by default to protect your privacy a
16   bit more.
17
18 - Experimental IPv6 support patch is available in the source package
19   but currently disabled because of too many side effects and bugs.
20   If you really need it, you can try to compile the Debian package
21   sources yourself and enable it in debian/patches/00list.
22
23 - The global default for all URLs (/) is no longer set in
24   default.action but in a new file global.action, so your local
25   changes should go to global.action and user.action only, while
26   default.action is maintained by package upgrades automatically.
27
28 - Since 3.0.5 the upstream package uses the Cautious default settings
29   instead of Medium (like 3.0.3 did).  To avoid problems on upgrades
30   of old packages, the Debian package still uses the Medium settings.
31   You can find the different profiles in /etc/privoxy/standard.action.
32   To change the default, go to http://p.p/edit-actions-list?f=global
33   (this can also be reached from http://p.p/show-status via the
34   global.action edit link.  p.p is a privoxy internal address, so you
35   need to use privoxy as your HTTP proxy before you can access these
36   URLs) and modify the default to your needs.  You can either set one
37   of the standard profiles (Cautious, Medium, or Advanced) or change
38   every single setting using the "Edit" button.  It is necessary to
39   set "enable-edit-actions 1" (see above) in /etc/privoxy/config to
40   use the web interface.  Alternatively you can modify
41   /etc/privoxy/global.action by hand.  The other templates are
42   available in /etc/privoxy/standard.action.
43
44 - /etc/privoxy/default.action is now owned by root, so you can not
45   modify it via http://p.p/edit-actions-list?f=default any longer
46   (assumed that you set "enable-edit-action 1" above).  You should
47   realize your local adaptions in /etc/privoxy/global.action and
48   /etc/privoxy/user.action, so default.action can be easily upgraded
49   by new package versions.  If you do not like this change, feel free
50   to change the owner of default.action to "privoxy" and the file is
51   editable again.
52
53 Roland Rosenfeld <roland@debian.org>
54 $Id: README.Debian,v 1.7 2007-10-21 10:07:04 roland Exp $