The Main Configuration File By default, the main configuration file is named config, with the exception of Windows, where it is named config. All options in the config file except for confdir and logdir are optional. Watch out in the below description for what happens if you leave them unset. Like the filter and action files, the config file is binary option websites plain text file and can be modified with a text editor like emacs, vim or notepad.
The manual itself is normally packaged with the binary distributions, so you probably want to set this to a locally installed copy. Use multiple times for multiple URLs. Use this option to relocate customized templates that should be kept. This directive specifies the directory the temporary files should be written to. Actions files contain all the per site and per URL configuration for ad blocking, cookie management, privacy considerations, etc.
The filter files contain content modification rules that use regular expressions. These rules permit powerful changes on the content of Web pages, and optionally the headers as well, e. A pre-defined filter file called default. See the section on the filter action for a list. It is recommended to place any locally adapted filters into a separate file, such as user. Depending on the debug options below, the logfile may be a privacy risk if third parties can get access to it.
For most troubleshooting purposes, you will have to change that, please refer to the debugging section for details. To prevent the logfile from growing indefinitely, it is recommended to periodically rotate or shorten it. Many operating systems support log rotation out of the box, some require additional software to do it. For details, please refer to the documentation for your operating system.
The effect is that access to untrusted sites will be granted — but only if a link from this trusted referrer was used to get there. There is a limit of 512 such entries, after which new entries will not be made. Possible applications include limiting Internet access for children. Debugging These options are mainly useful when tracing a problem. To select multiple debug levels, you can either add them or use multiple debug lines. A debug level of 1 is informative because it will show you each request as it happens. The other levels are probably only of interest if you are hunting down a specific problem.
If you are used to the more verbose settings, simply enable the debug lines below again. Please don’t file any support requests without trying to reproduce the problem with increased debug level first. Once you read the log messages, you may even be able to solve the problem on your own. Setting a fixed hostname works around the problem.
In other circumstances it might be desirable to show a hostname other than the one returned by the operating system. For example if the system has several different hostnames and you don’t want to use the first one. Note that Privoxy does not validate the specified hostname value. Suitable if your operating system does not support sharing IPv6 and IPv4 protocols on the same socket. IP address and if there are multiple, use the first one returned. IPv6 addresses containing colons have to be quoted by brackets. Some operating systems will prefer IPv6 to IPv4 addresses even if the system has no IPv6 connectivity which is usually not expected by the user.