All Foxy configuration files are regular ASCII files. Any text editor can be used to edit them. Both DOS and Unix line ends are allowed.
Foxy keeps an eye on its configuration files while it's running. When a file is changed, everything is reloaded, so usually there is no need to restart the service.
The table below summarizes Foxy configuration files.
| foxy.cfg | The main configuration file. Specifiies essential configuration parameters. This file cannot be modified using Foxy web-based user interface (web UI). It is assumed that this file will not change often, and can even be made read-only. |
| toggle.cfg | toggle.cfg is always located in the same directory as the main configuration file. Unlike the main configuration file, it contains parameters that change often (e.g. filtering, which enables/disables filtering). Parameters from this file can be changed using web UI. Think about this file as a modifiable portion of the main configuration file |
| filters.cfg | Filter configuation file. All filters are defined in this file. May be quite large. Location of this file may be specified by the filter_file parameter of the main configuration file. Can be modified using web UI. |
| categories.cfg | Categorizer configuation file. Defines content categories. Location of this file may be specified by the category_file parameter of the main configuration file. Can be modified using web UI (not yet). |
| whitelist.cfg | Whitelist configuation file. Defines a set of URLs that will not be filtered. Location of this file may be specified by the whitelist_file parameter of the main configuration file. Can be modified using web UI. |
| proxies.cfg | Proxy mapping configuration file. Maps target URLs to proxy servers to be used for those URLs. Location of this file may be specified by the proxy_file parameter of the main configuration file. Can be modified using web UI. |