This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<spanid="settings-outgoing"></span><h1><codeclass="docutils literal notranslate"><spanclass="pre">outgoing:</span></code><aclass="headerlink"href="#outgoing"title="Link to this heading">¶</a></h1>
<spanclass="w"></span><spanclass="nt">request_timeout</span><spanclass="p">:</span><spanclass="w"></span><spanclass="l l-Scalar l-Scalar-Plain">2.0</span><spanclass="w"></span><spanclass="c1"># default timeout in seconds, can be override by engine</span>
<spanclass="w"></span><spanclass="nt">max_request_timeout</span><spanclass="p">:</span><spanclass="w"></span><spanclass="l l-Scalar l-Scalar-Plain">10.0</span><spanclass="w"></span><spanclass="c1"># the maximum timeout in seconds</span>
<spanclass="w"></span><spanclass="nt">useragent_suffix</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">""</span><spanclass="w"></span><spanclass="c1"># information like an email address to the administrator</span>
<spanclass="w"></span><spanclass="nt">pool_connections</span><spanclass="p">:</span><spanclass="w"></span><spanclass="l l-Scalar l-Scalar-Plain">100</span><spanclass="w"></span><spanclass="c1"># Maximum number of allowable connections, or null</span>
<spanclass="w"></span><spanclass="c1"># for no limits. The default is 100.</span>
<spanclass="w"></span><spanclass="nt">pool_maxsize</span><spanclass="p">:</span><spanclass="w"></span><spanclass="l l-Scalar l-Scalar-Plain">10</span><spanclass="w"></span><spanclass="c1"># Number of allowable keep-alive connections, or null</span>
<spanclass="w"></span><spanclass="c1"># to always allow. The default is 10.</span>
<spanclass="w"></span><spanclass="nt">enable_http2</span><spanclass="p">:</span><spanclass="w"></span><spanclass="l l-Scalar l-Scalar-Plain">true</span><spanclass="w"></span><spanclass="c1"># See https://www.python-httpx.org/http2/</span>
<spanclass="w"></span><spanclass="c1"># uncomment below section if you want to use a custom server certificate</span>
<spanclass="w"></span><spanclass="c1"># see https://www.python-httpx.org/advanced/#changing-the-verification-defaults</span>
<spanclass="w"></span><spanclass="c1"># and https://www.python-httpx.org/compatibility/#ssl-configuration</span>
<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 SearXNG reactivity (the result page may take the time specified in the
timeout to load). Can be override by <codeclass="docutils literal notranslate"><spanclass="pre">timeout</span></code> in the <aclass="reference internal"href="settings_engine.html#settings-engine"><spanclass="std std-ref">engine:</span></a>.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">useragent_suffix</span></code> :</dt><dd><p>Suffix to the user-agent SearXNG 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>
</dl>
<dlclass="simple">
<dt><codeclass="docutils literal notranslate"><spanclass="pre">pool_maxsize</span></code>:</dt><dd><p>Number of allowable keep-alive connections, or <codeclass="docutils literal notranslate"><spanclass="pre">null</span></code> to always allow. The
default is 10. See <codeclass="docutils literal notranslate"><spanclass="pre">max_keepalive_connections</span></code><aclass="reference external"href="https://www.python-httpx.org/advanced/#pool-limit-configuration">Pool limit configuration</a>.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">pool_connections</span></code> :</dt><dd><p>Maximum number of allowable connections, or <codeclass="docutils literal notranslate"><spanclass="pre">null</span></code> # for no limits. The
default is 100. See <codeclass="docutils literal notranslate"><spanclass="pre">max_connections</span></code><aclass="reference external"href="https://www.python-httpx.org/advanced/#pool-limit-configuration">Pool limit configuration</a>.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">keepalive_expiry</span></code> :</dt><dd><p>Number of seconds to keep a connection in the pool. By default 5.0 seconds.
See <codeclass="docutils literal notranslate"><spanclass="pre">keepalive_expiry</span></code><aclass="reference external"href="https://www.python-httpx.org/advanced/#pool-limit-configuration">Pool limit configuration</a>.</p>
</dd>
</dl>
<dlclass="simple">
<dt><codeclass="docutils literal notranslate"><spanclass="pre">proxies</span></code> :</dt><dd><p>Define one or more proxies you wish to use, see <aclass="reference external"href="https://www.python-httpx.org/advanced/#http-proxying">httpx proxies</a>.
If there are more than one proxy for one protocol (http, https),
requests to the engines are distributed in a round-robin fashion.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">source_ips</span></code> :</dt><dd><p>If you use multiple network interfaces, define from which IP the requests must
be made. Example:</p>
<ulclass="simple">
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">0.0.0.0</span></code> any local IPv4 address.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">::</span></code> any local IPv6 address.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">[</span><spanclass="pre">192.168.0.1,</span><spanclass="pre">192.168.0.2</span><spanclass="pre">]</span></code> these two specific IP addresses</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">fe80::60a2:1691:e5a2:ee1f/126</span></code> all IP addresses in this network.</p></li>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">retries</span></code> :</dt><dd><p>Number of retry in case of an HTTP error. On each retry, SearXNG uses an
different proxy and source ip.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">enable_http2</span></code> :</dt><dd><p>Enable by default. Set to <codeclass="docutils literal notranslate"><spanclass="pre">false</span></code> to disable HTTP/2.</p>
</dd>
</dl>
<dl>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">verify</span></code>:<spanclass="classifier"><codeclass="docutils literal notranslate"><spanclass="pre">$SSL_CERT_FILE</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">$SSL_CERT_DIR</span></code></span></dt><dd><p>Allow to specify a path to certificate.
see <aclass="reference external"href="https://www.python-httpx.org/advanced/#changing-the-verification-defaults">httpx verification defaults</a>.</p>
<p>In addition to <codeclass="docutils literal notranslate"><spanclass="pre">verify</span></code>, SearXNG supports the <codeclass="docutils literal notranslate"><spanclass="pre">$SSL_CERT_FILE</span></code> (for a file) and
<codeclass="docutils literal notranslate"><spanclass="pre">$SSL_CERT_DIR</span></code> (for a directory) OpenSSL variables.
see <aclass="reference external"href="https://www.python-httpx.org/compatibility/#ssl-configuration">httpx ssl configuration</a>.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">max_redirects</span></code> :</dt><dd><p>30 by default. Maximum redirect before it is an error.</p>
</dd>
<dt><codeclass="docutils literal notranslate"><spanclass="pre">using_tor_proxy</span></code> :</dt><dd><p>Using tor proxy (<codeclass="docutils literal notranslate"><spanclass="pre">true</span></code>) or not (<codeclass="docutils literal notranslate"><spanclass="pre">false</span></code>) for all engines. The default is
<codeclass="docutils literal notranslate"><spanclass="pre">false</span></code> and can be overwritten in the <aclass="reference internal"href="settings_engine.html#settings-engine"><spanclass="std std-ref">engine:</span></a></p>