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 binary option websites 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 a 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.