<spanid="id1"></span><h1><codeclass="docutils literal notranslate"><spanclass="pre">settings.yml</span></code><aclass="headerlink"href="#settings-yml"title="Permalink to this headline">¶</a></h1>
<spanclass="l l-Scalar l-Scalar-Plain">useragent_suffix</span><spanclass="p p-Indicator">:</span><spanclass="s">""</span><spanclass="c1"># suffix of searx_useragent, could contain</span>
<spanclass="c1"># informations like admins email address</span>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">port</span></code> :</dt><dd><p>Port number of the searx web application if you run it directly using <codeclass="docutils literal notranslate"><spanclass="pre">python</span>
<spanclass="pre">searx/webapp.py</span></code>. Doesn’t apply to searx running on Apache or Nginx.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">secret_key</span></code> :</dt><dd><p>Used for cryptography purpose.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">debug</span></code> :</dt><dd><p>Allow a more detailed log if you run searx directly. Display <em>detailed</em> error
messages in the browser too, so this must be deactivated in production.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">request_timeout</span></code> :</dt><dd><p>Global timeout of the requests made to others engines in seconds. A bigger
timeout will allow to wait for answers from slow engines, but in consequence
will slow searx reactivity (the result page may take the time specified in the
timeout to load)</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">base_url</span></code> :</dt><dd><p>The base URL where searx is deployed. Used to create correct inbound links.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">themes_path</span></code> :</dt><dd><p>Path to where the themes are located. If you didn’t develop anything, leave it
blank.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">default_theme</span></code> :</dt><dd><p>Name of the theme you want to use by default on you searx instance.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">useragent_suffix</span></code> :</dt><dd><p>Suffix to the user-agent searx uses to send requests to others engines. If an
engine wish to block you, a contact info here may be useful to avoid that.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">image_proxy</span></code> :</dt><dd><p>Allow your instance of searx of being able to proxy images. Uses memory space.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">default_locale</span></code> :</dt><dd><p>Aearx interface language. If blank, the locale is detected by using the
browser language. If it doesn’t work, or you are deploying a language
specific instance of searx, a locale can be defined using an ISO language
<dt><codeclass="docutils literal notranslate"><spanclass="pre">outgoing_proxies</span></code> :</dt><dd><p>Define a proxy you wish to use, see <aclass="reference external"href="http://docs.python-requests.org/en/latest/user/advanced/#proxies">requests proxies</a>. SOCKS proxies are
not supported / see <cite>PR SOCKS support</cite>.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">source_ips</span></code> :</dt><dd><p>If you use multiple nework interfaces, define from which IP the requests must
be made.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">locales</span></code> :</dt><dd><p>Locales codes and their names. Available translations of searx interface.</p>
</dd>
</dl>
</div>
<divclass="section"id="engine-settings">
<spanid="settings-engine"></span><h2>Engine settings<aclass="headerlink"href="#engine-settings"title="Permalink to this headline">¶</a></h2>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">name</span></code> :</dt><dd><p>Name that will be used accross searx to define this engine. In settings, on
the result page…</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">engine</span></code> :</dt><dd><p>Name of the python file used to handle requests and responses to and from this
search engine.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">shortcut</span></code> :</dt><dd><p>Code used to execute bang requests (in this case using <codeclass="docutils literal notranslate"><spanclass="pre">!bi</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">?bi</span></code>)</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">base_url</span></code><spanclass="classifier">optional</span></dt><dd><p>Part of the URL that should be stable accross every request. Can be useful to
use multiple sites using only one engine, or updating the site URL without
touching at the code.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">categories</span></code><spanclass="classifier">optional</span></dt><dd><p>Define in which categories this engine will be active. Most of the time, it is
defined in the code of the engine, but in a few cases it is useful, like when
describing multiple search engine using the same code.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">timeout</span></code><spanclass="classifier">optional</span></dt><dd><p>Timeout of the search with the current search engine. <strong>Be careful, it will
modify the global timeout of searx.</strong></p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">api_key</span></code><spanclass="classifier">optional</span></dt><dd><p>In a few cases, using an API needs the use of a secret key. How to obtain them
is described in the file.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">disabled</span></code><spanclass="classifier">optional</span></dt><dd><p>To disable by default the engine, but not deleting it. It will allow the user
to manually activate it in the settings.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">language</span></code><spanclass="classifier">optional</span></dt><dd><p>If you want to use another language for a specific engine, you can define it
by using the full ISO code of language and country, like <codeclass="docutils literal notranslate"><spanclass="pre">fr_FR</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">en_US</span></code>,
<dt><codeclass="docutils literal notranslate"><spanclass="pre">weigth</span></code><spanclass="classifier">default <codeclass="docutils literal notranslate"><spanclass="pre">1</span></code></span></dt><dd><p>Weighting of the results of this engine.</p>
</dd>
</dl>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>A few more options are possible, but they are pretty specific to some
