Plugins¶
The built-in plugins can be activated or deactivated via the settings (enabled_plugins: (internal)) and external plugins can be integrated into SearXNG (plugins: (external)).
enabled_plugins:
(internal)¶
In List of plugins you find a complete list of all plugins, the default configuration looks like:
enabled_plugins:
- 'Basic Calculator'
- 'Hash plugin'
- 'Self Information'
- 'Tracker URL remover'
- 'Unit converter plugin'
- 'Ahmia blacklist'
plugins:
(external)¶
SearXNG supports external plugins / there is no need to install one, SearXNG runs out of the box. But to demonstrate; in the example below we install the SearXNG plugins from The Green Web Foundation [ref]:
$ sudo utils/searxng.sh instance cmd bash -c
(searxng-pyenv)$ pip install git+https://github.com/return42/tgwf-searx-plugins
In the settings.yml activate the plugins:
section and add module
only_show_green_results
from tgwf-searx-plugins
.
plugins:
- only_show_green_results
# - mypackage.mymodule.MyPlugin
# - mypackage.mymodule.MyOtherPlugin
Hint
only_show_green_results
is an old plugin that was still implemented in
the old style. There is a legacy treatment for backward compatibility, but
new plugins should be implemented as a searx.plugins.Plugin
class.