NTab仓库
fjmwkj
/
searxng
mirror of https://github.com/searxng/searxng
1
0
Fork 0
Files Issues 0 Wiki
Branch: gh-pages
Branches Tags
searxng
/
admin
/
installation-uwsgi.html

installation-uwsgi.html 47 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634 
  1. <!DOCTYPE html>
    2. 

  2. 

  3. <html lang="en" data-content_root="../">
    4. 

  4.   <head>
    5. 

  5.     <meta charset="utf-8" />
    6. 

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    7. 

  7.   <meta name="viewport" content="width=device-width, initial-scale=1">
    8. 

  8.     <title>uWSGI &#8212; SearXNG Documentation (2025.4.30+fd33559cf)</title>
    9. 

  9.     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=6625fa76" />
    10. 

  10.     <link rel="stylesheet" type="text/css" href="../_static/searxng.css?v=52e4ff28" />
    11. 

  11.     <link rel="stylesheet" type="text/css" href="../_static/tabs.css?v=a5c4661c" />
    12. 

  12.     <script src="../_static/documentation_options.js?v=b12b0e12"></script>
    13. 

  13.     <script src="../_static/doctools.js?v=9a2dae69"></script>
    14. 

  14.     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
    15. 

  15.     <script data-project="searxng" data-version="2025.4.30+fd33559cf" src="../_static/describe_version.js?v=fa7f30d0"></script>
    16. 

  16.     <script src="../_static/tabs.js?v=3030b3cb"></script>
    17. 

  17.     <link rel="index" title="Index" href="../genindex.html" />
    18. 

  18.     <link rel="search" title="Search" href="../search.html" />
    19. 

  19.     <link rel="next" title="NGINX" href="installation-nginx.html" />
    20. 

  20.     <link rel="prev" title="Step by step installation" href="installation-searxng.html" /> 
    21. 

  21.   </head><body>
    22. 

  22.     <div class="related" role="navigation" aria-label="Related">
    23. 

  23.       <h3>Navigation</h3>
    24. 

  24.       <ul>
    25. 

  25.         <li class="right" style="margin-right: 10px">
    26. 

  26.           <a href="../genindex.html" title="General Index"
    27. 

  27.              accesskey="I">index</a></li>
    28. 

  28.         <li class="right" >
    29. 

  29.           <a href="../py-modindex.html" title="Python Module Index"
    30. 

  30.              >modules</a> |</li>
    31. 

  31.         <li class="right" >
    32. 

  32.           <a href="installation-nginx.html" title="NGINX"
    33. 

  33.              accesskey="N">next</a> |</li>
    34. 

  34.         <li class="right" >
    35. 

  35.           <a href="installation-searxng.html" title="Step by step installation"
    36. 

  36.              accesskey="P">previous</a> |</li>
    37. 

  37.         <li class="nav-item nav-item-0"><a href="../index.html">SearXNG Documentation (2025.4.30+fd33559cf)</a> &#187;</li>
    38. 

  38.           <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Administrator documentation</a> &#187;</li>
    39. 

  39.         <li class="nav-item nav-item-this"><a href="">uWSGI</a></li> 
    40. 

  40.       </ul>
    41. 

  41.     </div>  
    42. 

  42. 

  43.     <div class="document">
    44. 

  44.       <div class="documentwrapper">
    45. 

  45.         <div class="bodywrapper">
    46. 

  46.           <div class="body" role="main">
    47. 

  47.             
    48. 

  48.   <section id="uwsgi">
    49. 

  49. <span id="searxng-uwsgi"></span><h1>uWSGI<a class="headerlink" href="#uwsgi" title="Link to this heading">¶</a></h1>
    50. 

  50. <aside class="sidebar">
    51. 

  51. <p class="sidebar-title">further reading</p>
    52. 

  52. <ul class="simple">
    53. 

  53. <li><p><a class="reference external" href="https://www.freedesktop.org/software/systemd/man/systemd.unit.html">systemd.unit</a></p></li>
    54. 

  54. <li><p><a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html">uWSGI Emperor</a></p></li>
    55. 

  55. </ul>
    56. 

  56. </aside>
    57. 

  57. <nav class="contents local" id="contents">
    58. 

  58. <ul class="simple">
    59. 

  59. <li><p><a class="reference internal" href="#origin-uwsgi" id="id7">Origin uWSGI</a></p></li>
    60. 

  60. <li><p><a class="reference internal" href="#distributors" id="id8">Distributors</a></p>
    61. 

  61. <ul>
    62. 

  62. <li><p><a class="reference internal" href="#debian-s-uwsgi-layout" id="id9">Debian’s uWSGI layout</a></p></li>
    63. 

  63. </ul>
    64. 

  64. </li>
    65. 

  65. <li><p><a class="reference internal" href="#uwsgi-maintenance" id="id10">uWSGI maintenance</a></p></li>
    66. 

  66. <li><p><a class="reference internal" href="#uwsgi-setup" id="id11">uWSGI setup</a></p></li>
    67. 

  67. <li><p><a class="reference internal" href="#pitfalls-of-the-tyrant-mode" id="id12">Pitfalls of the Tyrant mode</a></p></li>
    68. 

  68. </ul>
    69. 

  69. </nav>
    70. 

  70. <section id="origin-uwsgi">
    71. 

  71. <h2><a class="toc-backref" href="#id7" role="doc-backlink">Origin uWSGI</a><a class="headerlink" href="#origin-uwsgi" title="Link to this heading">¶</a></h2>
    72. 

  72. <p>How uWSGI is implemented by distributors varies. The uWSGI project itself
    73. 

  73. recommends two methods:</p>
    74. 

  74. <ol class="arabic simple">
    75. 

  75. <li><p><a class="reference external" href="https://www.freedesktop.org/software/systemd/man/systemd.unit.html">systemd.unit</a> template file as described here <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Systemd.html#one-service-per-app-in-systemd">One service per app in systemd</a>:</p></li>
    76. 

  76. </ol>
    77. 

  77. <blockquote>
    78. 

  78. <div><p>There is one <a class="reference external" href="http://0pointer.de/blog/projects/instances.html">systemd unit template</a> on the system installed and one <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#ini-files">uwsgi
    79. 

  79. ini file</a> per uWSGI-app placed at dedicated locations.  Take archlinux and a
    80. 

  80. <code class="docutils literal notranslate"><span class="pre">searxng.ini</span></code> as example:</p>
    81. 

  81. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">systemd</span> <span class="n">template</span> <span class="n">unit</span><span class="p">:</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">systemd</span><span class="o">/</span><span class="n">system</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">@.</span><span class="n">service</span>
    82. 

  82.         <span class="n">contains</span><span class="p">:</span> <span class="p">[</span><span class="n">Service</span><span class="p">]</span>
    83. 

  83.                   <span class="n">ExecStart</span><span class="o">=/</span><span class="n">usr</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">uwsgi</span> <span class="o">--</span><span class="n">ini</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/%</span><span class="n">I</span><span class="o">.</span><span class="n">ini</span>
    84. 

  84. 

  85. <span class="n">SearXNG</span> <span class="n">application</span><span class="p">:</span>   <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span>
    86. 

  86.         <span class="n">links</span> <span class="n">to</span><span class="p">:</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">apps</span><span class="o">-</span><span class="n">available</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span>
    87. 

  87. </pre></div>
    88. 

  88. </div>
    89. 

  89. <p>The SearXNG app (template <code class="docutils literal notranslate"><span class="pre">/etc/uwsgi/%I.ini</span></code>) can be maintained as known
    90. 

  90. from common systemd units:</p>
    91. 

  91. <div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>systemctl<span class="w"> </span><span class="nb">enable</span><span class="w">  </span>uwsgi@searxng
    92. 

  92. $<span class="w"> </span>systemctl<span class="w"> </span>start<span class="w">   </span>uwsgi@searxng
    93. 

  93. $<span class="w"> </span>systemctl<span class="w"> </span>restart<span class="w"> </span>uwsgi@searxng
    94. 

  94. $<span class="w"> </span>systemctl<span class="w"> </span>stop<span class="w">    </span>uwsgi@searxng
    95. 

  95. </pre></div>
    96. 

  96. </div>
    97. 

  97. </div></blockquote>
    98. 

  98. <ol class="arabic simple" start="2">
    99. 

  99. <li><p>The <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html">uWSGI Emperor</a> which fits for maintaining a large range of uwsgi
    100. 

  100. apps and there is a <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting">Tyrant mode</a> to secure multi-user hosting.</p></li>
    101. 

  101. </ol>
    102. 

  102. <blockquote>
    103. 

  103. <div><p>The Emperor mode is a special uWSGI instance that will monitor specific
    104. 

  104. events.  The Emperor mode (the service) is started by a (common, not template)
    105. 

  105. systemd unit.</p>
    106. 

  106. <p>The Emperor service will scan specific directories for <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#ini-files">uwsgi ini file</a>s
    107. 

  107. (also know as <em>vassals</em>).  If a <em>vassal</em> is added, removed or the timestamp is
    108. 

  108. modified, a corresponding action takes place: a new uWSGI instance is started,
    109. 

  109. reload or stopped.  Take Fedora and a <code class="docutils literal notranslate"><span class="pre">searxng.ini</span></code> as example:</p>
    110. 

  110. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">to</span> <span class="n">install</span> <span class="o">&amp;</span> <span class="n">start</span> <span class="n">SearXNG</span> <span class="n">instance</span> <span class="n">create</span> <span class="o">--&gt;</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span>
    111. 

  111. <span class="n">to</span> <span class="n">reload</span> <span class="n">the</span> <span class="n">instance</span> <span class="n">edit</span> <span class="n">timestamp</span>      <span class="o">--&gt;</span> <span class="n">touch</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span>
    112. 

  112. <span class="n">to</span> <span class="n">stop</span> <span class="n">instance</span> <span class="n">remove</span> <span class="n">ini</span>                <span class="o">--&gt;</span> <span class="n">rm</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">.</span><span class="n">d</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span>
    113. 

  113. </pre></div>
    114. 

  114. </div>
    115. 

  115. </div></blockquote>
    116. 

  116. </section>
    117. 

  117. <section id="distributors">
    118. 

  118. <h2><a class="toc-backref" href="#id8" role="doc-backlink">Distributors</a><a class="headerlink" href="#distributors" title="Link to this heading">¶</a></h2>
    119. 

  119. <p>The <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html">uWSGI Emperor</a> mode and <a class="reference external" href="http://0pointer.de/blog/projects/instances.html">systemd unit template</a> is what the distributors
    120. 

  120. mostly offer their users, even if they differ in the way they implement both
    121. 

  121. modes and their defaults.  Another point they might differ in is the packaging of
    122. 

  122. plugins (if so, compare <a class="reference internal" href="installation-searxng.html#install-packages"><span class="std std-ref">Install packages</span></a>) and what the default python
    123. 

  123. interpreter is (python2 vs. python3).</p>
    124. 

  124. <p>While archlinux does not start a uWSGI service by default, Fedora (RHEL) starts
    125. 

  125. a Emperor in <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting">Tyrant mode</a> by default (you should have read <a class="reference internal" href="#uwsgi-tyrant-mode-pitfalls"><span class="std std-ref">Pitfalls of the Tyrant mode</span></a>).  Worth to know; debian (ubuntu) follow a complete different
    126. 

  126. approach, read see <a class="reference internal" href="#debian-s-uwsgi-layout"><span class="std std-ref">Debian’s uWSGI layout</span></a>.</p>
    127. 

  127. <section id="debian-s-uwsgi-layout">
    128. 

  128. <span id="id1"></span><h3><a class="toc-backref" href="#id9" role="doc-backlink">Debian’s uWSGI layout</a><a class="headerlink" href="#debian-s-uwsgi-layout" title="Link to this heading">¶</a></h3>
    129. 

  129. <p>Be aware, Debian’s uWSGI layout is quite different from the standard uWSGI
    130. 

  130. configuration.  Your are familiar with <a class="reference internal" href="installation-apache.html#debian-s-apache-layout"><span class="std std-ref">Debian’s Apache layout</span></a>? .. they do a
    131. 

  131. similar thing for the uWSGI infrastructure. The folders are:</p>
    132. 

  132. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">apps</span><span class="o">-</span><span class="n">available</span><span class="o">/</span>
    133. 

  133. <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">apps</span><span class="o">-</span><span class="n">enabled</span><span class="o">/</span>
    134. 

  134. </pre></div>
    135. 

  135. </div>
    136. 

  136. <p>The <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Configuration.html#ini-files">uwsgi ini file</a> is enabled by a symbolic link:</p>
    137. 

  137. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">ln</span> <span class="o">-</span><span class="n">s</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">apps</span><span class="o">-</span><span class="n">available</span><span class="o">/</span><span class="n">searxng</span><span class="o">.</span><span class="n">ini</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">uwsgi</span><span class="o">/</span><span class="n">apps</span><span class="o">-</span><span class="n">enabled</span><span class="o">/</span>
    138. 

  138. </pre></div>
    139. 

  139. </div>
    140. 

  140. <p>More details can be found in the <a class="reference external" href="https://salsa.debian.org/uwsgi-team/uwsgi/-/raw/debian/latest/debian/uwsgi.README.Debian">uwsgi.README.Debian</a>
    141. 

  141. (<code class="docutils literal notranslate"><span class="pre">/usr/share/doc/uwsgi/README.Debian.gz</span></code>).  Some commands you should know on
    142. 

  142. Debian:</p>
    143. 

  143. <div class="highlight-none notranslate"><div class="highlight"><pre><span></span>Commands recognized by init.d script
    144. 

  144. ====================================
    145. 

  145. 

  146. You can issue to init.d script following commands:
    147. 

  147.   * start        | starts daemon
    148. 

  148.   * stop         | stops daemon
    149. 

  149.   * reload       | sends to daemon SIGHUP signal
    150. 

  150.   * force-reload | sends to daemon SIGTERM signal
    151. 

  151.   * restart      | issues &#39;stop&#39;, then &#39;start&#39; commands
    152. 

  152.   * status       | shows status of daemon instance (running/not running)
    153. 

  153. 

  154. &#39;status&#39; command must be issued with exactly one argument: &#39;&lt;confname&gt;&#39;.
    155. 

  155. 

  156. Controlling specific instances of uWSGI
    157. 

  157. =======================================
    158. 

  158. 

  159. You could control specific instance(s) by issuing:
    160. 

  160. 

  161.     SYSTEMCTL_SKIP_REDIRECT=1 service uwsgi &lt;command&gt; &lt;confname&gt; &lt;confname&gt;...
    162. 

  162. 

  163. where:
    164. 

  164.   * &lt;command&gt; is one of &#39;start&#39;, &#39;stop&#39; etc.
    165. 

  165.   * &lt;confname&gt; is the name of configuration file (without extension)
    166. 

  166. 

  167. For example, this is how instance for /etc/uwsgi/apps-enabled/hello.xml is
    168. 

  168. started:
    169. 

  169. 

  170.     SYSTEMCTL_SKIP_REDIRECT=1 service uwsgi start hello
    171. 

  171. </pre></div>
    172. 

  172. </div>
    173. 

  173. </section>
    174. 

  174. </section>
    175. 

  175. <section id="uwsgi-maintenance">
    176. 

  176. <span id="id2"></span><h2><a class="toc-backref" href="#id10" role="doc-backlink">uWSGI maintenance</a><a class="headerlink" href="#uwsgi-maintenance" title="Link to this heading">¶</a></h2>
    177. 

  177. <div class="sphinx-tabs docutils container">
    178. 

  178. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-0-VWJ1bnR1IC8gZGViaWFu" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-0-VWJ1bnR1IC8gZGViaWFu" name="VWJ1bnR1IC8gZGViaWFu" role="tab" tabindex="0">Ubuntu / debian</button><button aria-controls="panel-0-QXJjaCBMaW51eA==" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-0-QXJjaCBMaW51eA==" name="QXJjaCBMaW51eA==" role="tab" tabindex="-1">Arch Linux</button><button aria-controls="panel-0-RmVkb3JhIC8gUkhFTA==" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-0-RmVkb3JhIC8gUkhFTA==" name="RmVkb3JhIC8gUkhFTA==" role="tab" tabindex="-1">Fedora / RHEL</button></div><div aria-labelledby="tab-0-VWJ1bnR1IC8gZGViaWFu" class="sphinx-tabs-panel group-tab" id="panel-0-VWJ1bnR1IC8gZGViaWFu" name="VWJ1bnR1IC8gZGViaWFu" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># init.d --&gt; /usr/share/doc/uwsgi/README.Debian.gz</span>
    179. 

  179. <span class="c1"># For uWSGI debian uses the LSB init process, this might be changed</span>
    180. 

  180. <span class="c1"># one day, see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=833067</span>
    181. 

  181. 

  182. create<span class="w">     </span>/etc/uwsgi/apps-available/searxng.ini
    183. 

  183. enable:<span class="w">    </span>sudo<span class="w"> </span>-H<span class="w"> </span>ln<span class="w"> </span>-s<span class="w"> </span>/etc/uwsgi/apps-available/searxng.ini<span class="w"> </span>/etc/uwsgi/apps-enabled/
    184. 

  184. start:<span class="w">     </span>sudo<span class="w"> </span>-H<span class="w"> </span>service<span class="w"> </span>uwsgi<span class="w"> </span>start<span class="w">   </span>searxng
    185. 

  185. restart:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>service<span class="w"> </span>uwsgi<span class="w"> </span>restart<span class="w"> </span>searxng
    186. 

  186. stop:<span class="w">      </span>sudo<span class="w"> </span>-H<span class="w"> </span>service<span class="w"> </span>uwsgi<span class="w"> </span>stop<span class="w">    </span>searxng
    187. 

  187. disable:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>rm<span class="w"> </span>/etc/uwsgi/apps-enabled/searxng.ini
    188. 

  188. </pre></div>
    189. 

  189. </div>
    190. 

  190. </div><div aria-labelledby="tab-0-QXJjaCBMaW51eA==" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-0-QXJjaCBMaW51eA==" name="QXJjaCBMaW51eA==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># systemd --&gt; /usr/lib/systemd/system/uwsgi@.service</span>
    191. 

  191. <span class="c1"># For uWSGI archlinux uses systemd template units, see</span>
    192. 

  192. <span class="c1"># - http://0pointer.de/blog/projects/instances.html</span>
    193. 

  193. <span class="c1"># - https://uwsgi-docs.readthedocs.io/en/latest/Systemd.html#one-service-per-app-in-systemd</span>
    194. 

  194. 

  195. create:<span class="w">    </span>/etc/uwsgi/searxng.ini
    196. 

  196. enable:<span class="w">    </span>sudo<span class="w"> </span>-H<span class="w"> </span>systemctl<span class="w"> </span><span class="nb">enable</span><span class="w">   </span>uwsgi@searxng
    197. 

  197. start:<span class="w">     </span>sudo<span class="w"> </span>-H<span class="w"> </span>systemctl<span class="w"> </span>start<span class="w">    </span>uwsgi@searxng
    198. 

  198. restart:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>systemctl<span class="w"> </span>restart<span class="w">  </span>uwsgi@searxng
    199. 

  199. stop:<span class="w">      </span>sudo<span class="w"> </span>-H<span class="w"> </span>systemctl<span class="w"> </span>stop<span class="w">     </span>uwsgi@searxng
    200. 

  200. disable:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>systemctl<span class="w"> </span>disable<span class="w">  </span>uwsgi@searxng
    201. 

  201. </pre></div>
    202. 

  202. </div>
    203. 

  203. </div><div aria-labelledby="tab-0-RmVkb3JhIC8gUkhFTA==" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-0-RmVkb3JhIC8gUkhFTA==" name="RmVkb3JhIC8gUkhFTA==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># systemd --&gt; /usr/lib/systemd/system/uwsgi.service</span>
    204. 

  204. <span class="c1"># The unit file starts uWSGI in emperor mode (/etc/uwsgi.ini), see</span>
    205. 

  205. <span class="c1"># - https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html</span>
    206. 

  206. 

  207. create:<span class="w">    </span>/etc/uwsgi.d/searxng.ini
    208. 

  208. restart:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>touch<span class="w"> </span>/etc/uwsgi.d/searxng.ini
    209. 

  209. disable:<span class="w">   </span>sudo<span class="w"> </span>-H<span class="w"> </span>rm<span class="w"> </span>/etc/uwsgi.d/searxng.ini
    210. 

  210. </pre></div>
    211. 

  211. </div>
    212. 

  212. </div></div>
    213. 

  213. </section>
    214. 

  214. <section id="uwsgi-setup">
    215. 

  215. <span id="id3"></span><h2><a class="toc-backref" href="#id11" role="doc-backlink">uWSGI setup</a><a class="headerlink" href="#uwsgi-setup" title="Link to this heading">¶</a></h2>
    216. 

  216. <p>Create the configuration ini-file according to your distribution and restart the
    217. 

  217. uwsgi application.  As shown below, the <a class="reference internal" href="installation-scripts.html#installation-scripts"><span class="std std-ref">Installation Script</span></a> installs by
    218. 

  218. default:</p>
    219. 

  219. <ul class="simple">
    220. 

  220. <li><p>a uWSGI setup that listens on a socket and</p></li>
    221. 

  221. <li><p>enables <a class="reference internal" href="settings/settings_ui.html#static-use-hash"><span class="std std-ref">cache busting</span></a>.</p></li>
    222. 

  222. </ul>
    223. 

  223. <div class="sphinx-tabs docutils container">
    224. 

  224. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-1-VWJ1bnR1IC8gZGViaWFu" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-1-VWJ1bnR1IC8gZGViaWFu" name="VWJ1bnR1IC8gZGViaWFu" role="tab" tabindex="0">Ubuntu / debian</button><button aria-controls="panel-1-QXJjaCBMaW51eA==" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-1-QXJjaCBMaW51eA==" name="QXJjaCBMaW51eA==" role="tab" tabindex="-1">Arch Linux</button><button aria-controls="panel-1-RmVkb3JhIC8gUkhFTA==" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-1-RmVkb3JhIC8gUkhFTA==" name="RmVkb3JhIC8gUkhFTA==" role="tab" tabindex="-1">Fedora / RHEL</button></div><div aria-labelledby="tab-1-VWJ1bnR1IC8gZGViaWFu" class="sphinx-tabs-panel group-tab" id="panel-1-VWJ1bnR1IC8gZGViaWFu" name="VWJ1bnR1IC8gZGViaWFu" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># -*- mode: conf; coding: utf-8  -*-</span>
    225. 

  225. <span class="o">[</span>uwsgi<span class="o">]</span>
    226. 

  226. 

  227. <span class="c1"># uWSGI core</span>
    228. 

  228. <span class="c1"># ----------</span>
    229. 

  229. <span class="c1">#</span>
    230. 

  230. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#uwsgi-core</span>
    231. 

  231. 

  232. <span class="c1"># Who will run the code / Hint: in emperor-tyrant mode uid &amp; gid setting will be</span>
    233. 

  233. <span class="c1"># ignored [1].  Mode emperor-tyrant is the default on fedora (/etc/uwsgi.ini).</span>
    234. 

  234. <span class="c1">#</span>
    235. 

  235. <span class="c1"># [1] https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting</span>
    236. 

  236. <span class="c1">#</span>
    237. 

  237. <span class="nv">uid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    238. 

  238. <span class="nv">gid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    239. 

  239. 

  240. <span class="c1"># set (python) default encoding UTF-8</span>
    241. 

  241. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANG</span><span class="o">=</span>C.UTF-8
    242. 

  242. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANGUAGE</span><span class="o">=</span>C.UTF-8
    243. 

  243. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LC_ALL</span><span class="o">=</span>C.UTF-8
    244. 

  244. 

  245. <span class="c1"># chdir to specified directory before apps loading</span>
    246. 

  246. <span class="nv">chdir</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src/searx
    247. 

  247. 

  248. <span class="c1"># SearXNG configuration (settings.yml)</span>
    249. 

  249. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">SEARXNG_SETTINGS_PATH</span><span class="o">=</span>/etc/searxng/settings.yml
    250. 

  250. 

  251. <span class="c1"># disable logging for privacy</span>
    252. 

  252. disable-logging<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    253. 

  253. 

  254. <span class="c1"># The right granted on the created socket</span>
    255. 

  255. chmod-socket<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">666</span>
    256. 

  256. 

  257. <span class="c1"># Plugin to use and interpreter config</span>
    258. 

  258. single-interpreter<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    259. 

  259. 

  260. <span class="c1"># enable master process</span>
    261. 

  261. <span class="nv">master</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    262. 

  262. 

  263. <span class="c1"># load apps in each worker instead of the master</span>
    264. 

  264. lazy-apps<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    265. 

  265. 

  266. <span class="c1"># load uWSGI plugins</span>
    267. 

  267. <span class="nv">plugin</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>python3,http
    268. 

  268. 

  269. <span class="c1"># By default the Python plugin does not initialize the GIL.  This means your</span>
    270. 

  270. <span class="c1"># app-generated threads will not run.  If you need threads, remember to enable</span>
    271. 

  271. <span class="c1"># them with enable-threads.  Running uWSGI in multithreading mode (with the</span>
    272. 

  272. <span class="c1"># threads options) will automatically enable threading support. This *strange*</span>
    273. 

  273. <span class="c1"># default behaviour is for performance reasons.</span>
    274. 

  274. enable-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    275. 

  275. 

  276. <span class="c1"># Number of workers (usually CPU count)</span>
    277. 

  277. <span class="nv">workers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    278. 

  278. <span class="nv">threads</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">4</span>
    279. 

  279. 

  280. <span class="c1"># plugin: python</span>
    281. 

  281. <span class="c1"># --------------</span>
    282. 

  282. <span class="c1">#</span>
    283. 

  283. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#plugin-python</span>
    284. 

  284. 

  285. <span class="c1"># load a WSGI module</span>
    286. 

  286. <span class="nv">module</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searx.webapp
    287. 

  287. 

  288. <span class="c1"># set PYTHONHOME/virtualenv</span>
    289. 

  289. <span class="nv">virtualenv</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searx-pyenv
    290. 

  290. 

  291. <span class="c1"># add directory (or glob) to pythonpath</span>
    292. 

  292. <span class="nv">pythonpath</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src
    293. 

  293. 

  294. 

  295. <span class="c1"># speak to upstream</span>
    296. 

  296. <span class="c1"># -----------------</span>
    297. 

  297. 

  298. <span class="nv">socket</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/run/socket
    299. 

  299. buffer-size<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">8192</span>
    300. 

  300. 

  301. <span class="c1"># uWSGI serves the static files and in settings.yml we use::</span>
    302. 

  302. <span class="c1">#</span>
    303. 

  303. <span class="c1">#   ui:</span>
    304. 

  304. <span class="c1">#     static_use_hash: true</span>
    305. 

  305. <span class="c1">#</span>
    306. 

  306. static-map<span class="w"> </span><span class="o">=</span><span class="w"> </span>/static<span class="o">=</span>/usr/local/searxng/searxng-src/searx/static
    307. 

  307. static-gzip-all<span class="w"> </span><span class="o">=</span><span class="w"> </span>True
    308. 

  308. offload-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    309. 

  309. </pre></div>
    310. 

  310. </div>
    311. 

  311. </div><div aria-labelledby="tab-1-QXJjaCBMaW51eA==" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-1-QXJjaCBMaW51eA==" name="QXJjaCBMaW51eA==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># -*- mode: conf; coding: utf-8  -*-</span>
    312. 

  312. <span class="o">[</span>uwsgi<span class="o">]</span>
    313. 

  313. 

  314. <span class="c1"># uWSGI core</span>
    315. 

  315. <span class="c1"># ----------</span>
    316. 

  316. <span class="c1">#</span>
    317. 

  317. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#uwsgi-core</span>
    318. 

  318. 

  319. <span class="c1"># Who will run the code</span>
    320. 

  320. <span class="nv">uid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    321. 

  321. <span class="nv">gid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    322. 

  322. 

  323. <span class="c1"># set (python) default encoding UTF-8</span>
    324. 

  324. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANG</span><span class="o">=</span>C.UTF-8
    325. 

  325. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANGUAGE</span><span class="o">=</span>C.UTF-8
    326. 

  326. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LC_ALL</span><span class="o">=</span>C.UTF-8
    327. 

  327. 

  328. <span class="c1"># chdir to specified directory before apps loading</span>
    329. 

  329. <span class="nv">chdir</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src/searx
    330. 

  330. 

  331. <span class="c1"># SearXNG configuration (settings.yml)</span>
    332. 

  332. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">SEARXNG_SETTINGS_PATH</span><span class="o">=</span>/etc/searxng/settings.yml
    333. 

  333. 

  334. <span class="c1"># disable logging for privacy</span>
    335. 

  335. <span class="nv">logger</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>systemd
    336. 

  336. disable-logging<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    337. 

  337. 

  338. <span class="c1"># The right granted on the created socket</span>
    339. 

  339. chmod-socket<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">666</span>
    340. 

  340. 

  341. <span class="c1"># Plugin to use and interpreter config</span>
    342. 

  342. single-interpreter<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    343. 

  343. 

  344. <span class="c1"># enable master process</span>
    345. 

  345. <span class="nv">master</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    346. 

  346. 

  347. <span class="c1"># load apps in each worker instead of the master</span>
    348. 

  348. lazy-apps<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    349. 

  349. 

  350. <span class="c1"># load uWSGI plugins</span>
    351. 

  351. <span class="nv">plugin</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>python
    352. 

  352. 

  353. <span class="c1"># By default the Python plugin does not initialize the GIL.  This means your</span>
    354. 

  354. <span class="c1"># app-generated threads will not run.  If you need threads, remember to enable</span>
    355. 

  355. <span class="c1"># them with enable-threads.  Running uWSGI in multithreading mode (with the</span>
    356. 

  356. <span class="c1"># threads options) will automatically enable threading support. This *strange*</span>
    357. 

  357. <span class="c1"># default behaviour is for performance reasons.</span>
    358. 

  358. enable-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    359. 

  359. 

  360. <span class="c1"># Number of workers (usually CPU count)</span>
    361. 

  361. <span class="nv">workers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    362. 

  362. <span class="nv">threads</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">4</span>
    363. 

  363. 

  364. <span class="c1"># plugin: python</span>
    365. 

  365. <span class="c1"># --------------</span>
    366. 

  366. <span class="c1">#</span>
    367. 

  367. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#plugin-python</span>
    368. 

  368. 

  369. <span class="c1"># load a WSGI module</span>
    370. 

  370. <span class="nv">module</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searx.webapp
    371. 

  371. 

  372. <span class="c1"># set PYTHONHOME/virtualenv</span>
    373. 

  373. <span class="nv">virtualenv</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searx-pyenv
    374. 

  374. 

  375. <span class="c1"># add directory (or glob) to pythonpath</span>
    376. 

  376. <span class="nv">pythonpath</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src
    377. 

  377. 

  378. 

  379. <span class="c1"># speak to upstream</span>
    380. 

  380. <span class="c1"># -----------------</span>
    381. 

  381. 

  382. <span class="nv">socket</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/run/socket
    383. 

  383. buffer-size<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">8192</span>
    384. 

  384. 

  385. <span class="c1"># uWSGI serves the static files and in settings.yml we use::</span>
    386. 

  386. <span class="c1">#</span>
    387. 

  387. <span class="c1">#   ui:</span>
    388. 

  388. <span class="c1">#     static_use_hash: true</span>
    389. 

  389. <span class="c1">#</span>
    390. 

  390. static-map<span class="w"> </span><span class="o">=</span><span class="w"> </span>/static<span class="o">=</span>/usr/local/searxng/searxng-src/searx/static
    391. 

  391. static-gzip-all<span class="w"> </span><span class="o">=</span><span class="w"> </span>True
    392. 

  392. offload-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    393. 

  393. </pre></div>
    394. 

  394. </div>
    395. 

  395. </div><div aria-labelledby="tab-1-RmVkb3JhIC8gUkhFTA==" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-1-RmVkb3JhIC8gUkhFTA==" name="RmVkb3JhIC8gUkhFTA==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="c1"># -*- mode: conf; coding: utf-8  -*-</span>
    396. 

  396. <span class="o">[</span>uwsgi<span class="o">]</span>
    397. 

  397. 

  398. <span class="c1"># uWSGI core</span>
    399. 

  399. <span class="c1"># ----------</span>
    400. 

  400. <span class="c1">#</span>
    401. 

  401. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#uwsgi-core</span>
    402. 

  402. 

  403. <span class="c1"># Who will run the code / Hint: in emperor-tyrant mode uid &amp; gid setting will be</span>
    404. 

  404. <span class="c1"># ignored [1].  Mode emperor-tyrant is the default on fedora (/etc/uwsgi.ini).</span>
    405. 

  405. <span class="c1">#</span>
    406. 

  406. <span class="c1"># [1] https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting</span>
    407. 

  407. <span class="c1">#</span>
    408. 

  408. <span class="nv">uid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    409. 

  409. <span class="nv">gid</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searxng
    410. 

  410. 

  411. <span class="c1"># set (python) default encoding UTF-8</span>
    412. 

  412. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANG</span><span class="o">=</span>C.UTF-8
    413. 

  413. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LANGUAGE</span><span class="o">=</span>C.UTF-8
    414. 

  414. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">LC_ALL</span><span class="o">=</span>C.UTF-8
    415. 

  415. 

  416. <span class="c1"># chdir to specified directory before apps loading</span>
    417. 

  417. <span class="nv">chdir</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src/searx
    418. 

  418. 

  419. <span class="c1"># SearXNG configuration (settings.yml)</span>
    420. 

  420. <span class="nv">env</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">SEARXNG_SETTINGS_PATH</span><span class="o">=</span>/etc/searxng/settings.yml
    421. 

  421. 

  422. <span class="c1"># disable logging for privacy</span>
    423. 

  423. disable-logging<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    424. 

  424. 

  425. <span class="c1"># The right granted on the created socket</span>
    426. 

  426. chmod-socket<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">666</span>
    427. 

  427. 

  428. <span class="c1"># Plugin to use and interpreter config</span>
    429. 

  429. single-interpreter<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    430. 

  430. 

  431. <span class="c1"># enable master process</span>
    432. 

  432. <span class="nv">master</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    433. 

  433. 

  434. <span class="c1"># load apps in each worker instead of the master</span>
    435. 

  435. lazy-apps<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    436. 

  436. 

  437. <span class="c1"># load uWSGI plugins</span>
    438. 

  438. <span class="nv">plugin</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>python3,http
    439. 

  439. 

  440. <span class="c1"># By default the Python plugin does not initialize the GIL.  This means your</span>
    441. 

  441. <span class="c1"># app-generated threads will not run.  If you need threads, remember to enable</span>
    442. 

  442. <span class="c1"># them with enable-threads.  Running uWSGI in multithreading mode (with the</span>
    443. 

  443. <span class="c1"># threads options) will automatically enable threading support. This *strange*</span>
    444. 

  444. <span class="c1"># default behaviour is for performance reasons.</span>
    445. 

  445. enable-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span>
    446. 

  446. 

  447. <span class="c1"># Number of workers (usually CPU count)</span>
    448. 

  448. <span class="nv">workers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    449. 

  449. <span class="nv">threads</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">4</span>
    450. 

  450. 

  451. <span class="c1"># plugin: python</span>
    452. 

  452. <span class="c1"># --------------</span>
    453. 

  453. <span class="c1">#</span>
    454. 

  454. <span class="c1"># https://uwsgi-docs.readthedocs.io/en/latest/Options.html#plugin-python</span>
    455. 

  455. 

  456. <span class="c1"># load a WSGI module</span>
    457. 

  457. <span class="nv">module</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>searx.webapp
    458. 

  458. 

  459. <span class="c1"># set PYTHONHOME/virtualenv</span>
    460. 

  460. <span class="nv">virtualenv</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searx-pyenv
    461. 

  461. 

  462. <span class="c1"># add directory (or glob) to pythonpath</span>
    463. 

  463. <span class="nv">pythonpath</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/searxng-src
    464. 

  464. 

  465. 

  466. <span class="c1"># speak to upstream</span>
    467. 

  467. <span class="c1"># -----------------</span>
    468. 

  468. 

  469. <span class="nv">socket</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>/usr/local/searxng/run/socket
    470. 

  470. buffer-size<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">8192</span>
    471. 

  471. 

  472. <span class="c1"># uWSGI serves the static files and in settings.yml we use::</span>
    473. 

  473. <span class="c1">#</span>
    474. 

  474. <span class="c1">#   ui:</span>
    475. 

  475. <span class="c1">#     static_use_hash: true</span>
    476. 

  476. <span class="c1">#</span>
    477. 

  477. static-map<span class="w"> </span><span class="o">=</span><span class="w"> </span>/static<span class="o">=</span>/usr/local/searxng/searxng-src/searx/static
    478. 

  478. static-gzip-all<span class="w"> </span><span class="o">=</span><span class="w"> </span>True
    479. 

  479. offload-threads<span class="w"> </span><span class="o">=</span><span class="w"> </span>%k
    480. 

  480. </pre></div>
    481. 

  481. </div>
    482. 

  482. </div></div>
    483. 

  483. </section>
    484. 

  484. <section id="pitfalls-of-the-tyrant-mode">
    485. 

  485. <span id="uwsgi-tyrant-mode-pitfalls"></span><h2><a class="toc-backref" href="#id12" role="doc-backlink">Pitfalls of the Tyrant mode</a><a class="headerlink" href="#pitfalls-of-the-tyrant-mode" title="Link to this heading">¶</a></h2>
    486. 

  486. <p>The implementation of the process owners and groups in the <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting">Tyrant mode</a> is
    487. 

  487. somewhat unusual and requires special consideration.  In <a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Emperor.html#tyrant-mode-secure-multi-user-hosting">Tyrant mode</a> mode the
    488. 

  488. Emperor will run the vassal using the UID/GID of the vassal configuration file
    489. 

  489. (user and group of the app <code class="docutils literal notranslate"><span class="pre">.ini</span></code> file).</p>
    490. 

  490. <p>Without option <code class="docutils literal notranslate"><span class="pre">emperor-tyrant-initgroups=true</span></code> in <code class="docutils literal notranslate"><span class="pre">/etc/uwsgi.ini</span></code> the
    491. 

  491. process won’t get the additional groups, but this option is not available in
    492. 

  492. 2.0.x branch (see <a class="reference external" href="https://github.com/unbit/uwsgi/issues/2099">#2099&#64;uWSGI</a>) the feature <a class="reference external" href="https://github.com/unbit/uwsgi/pull/752">#752&#64;uWSGI</a> has been merged (on
    493. 

  493. Oct. 2014) to the master branch of uWSGI but had never been released; the last
    494. 

  494. major release is from Dec. 2013, since the there had been only bugfix releases
    495. 

  495. (see <a class="reference external" href="https://github.com/unbit/uwsgi/issues/2425">#2425uWSGI</a>). To shorten up:</p>
    496. 

  496. <blockquote>
    497. 

  497. <div><p><strong>In Tyrant mode, there is no way to get additional groups, and the uWSGI
    498. 

  498. process misses additional permissions that may be needed.</strong></p>
    499. 

  499. </div></blockquote>
    500. 

  500. <p>For example on Fedora (RHEL): If you try to install a redis DB with socket
    501. 

  501. communication and you want to connect to it from the SearXNG uWSGI, you will see a
    502. 

  502. <em>Permission denied</em> in the log of your instance:</p>
    503. 

  503. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>ERROR:searx.redisdb: [searxng (993)] can&#39;t connect redis DB ...
    504. 

  504. ERROR:searx.redisdb:   Error 13 connecting to unix socket: /usr/local/searxng-redis/run/redis.sock. Permission denied.
    505. 

  505. ERROR:searx.plugins.limiter: init limiter DB failed!!!
    506. 

  506. </pre></div>
    507. 

  507. </div>
    508. 

  508. <p>Even if your <em>searxng</em> user of the uWSGI process is added to additional groups
    509. 

  509. to give access to the socket from the redis DB:</p>
    510. 

  510. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ groups searxng
    511. 

  511. searxng : searxng searxng-redis
    512. 

  512. </pre></div>
    513. 

  513. </div>
    514. 

  514. <p>To see the effective groups of the uwsgi process, you have to look at the status
    515. 

  515. of the process, by example:</p>
    516. 

  516. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ ps -aef | grep &#39;/usr/sbin/uwsgi --ini searxng.ini&#39;
    517. 

  517. searxng       93      92  0 12:43 ?        00:00:00 /usr/sbin/uwsgi --ini searxng.ini
    518. 

  518. searxng      186      93  0 12:44 ?        00:00:01 /usr/sbin/uwsgi --ini searxng.ini
    519. 

  519. </pre></div>
    520. 

  520. </div>
    521. 

  521. <p>Here you can see that the additional “Groups” of PID 186 are unset (missing gid
    522. 

  522. of <code class="docutils literal notranslate"><span class="pre">searxng-redis</span></code>):</p>
    523. 

  523. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ cat /proc/186/task/186/status
    524. 

  524. ...
    525. 

  525. Uid:      993     993     993     993
    526. 

  526. Gid:      993     993     993     993
    527. 

  527. FDSize:   128
    528. 

  528. Groups:
    529. 

  529. ...
    530. 

  530. </pre></div>
    531. 

  531. </div>
    532. 

  532. </section>
    533. 

  533. </section>
    534. 

  534. 

  535. 

  536.             <div class="clearer"></div>
    537. 

  537.           </div>
    538. 

  538.         </div>
    539. 

  539.       </div>
    540. 

  540.   <span id="sidebar-top"></span>
    541. 

  541.       <div class="sphinxsidebar" role="navigation" aria-label="Main">
    542. 

  542.         <div class="sphinxsidebarwrapper">
    543. 

  543.   
    544. 

  544.     
    545. 

  545.             <p class="logo"><a href="../index.html">
    546. 

  546.               <img class="logo" src="../_static/searxng-wordmark.svg" alt="Logo of SearXNG"/>
    547. 

  547.             </a></p>
    548. 

  548.   
    549. 

  549. 

  550. <h3><a href="../index.html">Table of Contents</a></h3>
    551. 

  551. <ul class="current">
    552. 

  552. <li class="toctree-l1"><a class="reference internal" href="../user/index.html">User information</a></li>
    553. 

  553. <li class="toctree-l1"><a class="reference internal" href="../own-instance.html">Why use a private instance?</a></li>
    554. 

  554. <li class="toctree-l1 current"><a class="reference internal" href="index.html">Administrator documentation</a><ul class="current">
    555. 

  555. <li class="toctree-l2"><a class="reference internal" href="settings/index.html">Settings</a></li>
    556. 

  556. <li class="toctree-l2"><a class="reference internal" href="installation.html">Installation</a></li>
    557. 

  557. <li class="toctree-l2"><a class="reference internal" href="installation-docker.html">Docker Container</a></li>
    558. 

  558. <li class="toctree-l2"><a class="reference internal" href="installation-scripts.html">Installation Script</a></li>
    559. 

  559. <li class="toctree-l2"><a class="reference internal" href="installation-searxng.html">Step by step installation</a></li>
    560. 

  560. <li class="toctree-l2 current"><a class="current reference internal" href="#">uWSGI</a><ul>
    561. 

  561. <li class="toctree-l3"><a class="reference internal" href="#origin-uwsgi">Origin uWSGI</a></li>
    562. 

  562. <li class="toctree-l3"><a class="reference internal" href="#distributors">Distributors</a><ul>
    563. 

  563. <li class="toctree-l4"><a class="reference internal" href="#debian-s-uwsgi-layout">Debian’s uWSGI layout</a></li>
    564. 

  564. </ul>
    565. 

  565. </li>
    566. 

  566. <li class="toctree-l3"><a class="reference internal" href="#uwsgi-maintenance">uWSGI maintenance</a></li>
    567. 

  567. <li class="toctree-l3"><a class="reference internal" href="#uwsgi-setup">uWSGI setup</a></li>
    568. 

  568. <li class="toctree-l3"><a class="reference internal" href="#pitfalls-of-the-tyrant-mode">Pitfalls of the Tyrant mode</a></li>
    569. 

  569. </ul>
    570. 

  570. </li>
    571. 

  571. <li class="toctree-l2"><a class="reference internal" href="installation-nginx.html">NGINX</a></li>
    572. 

  572. <li class="toctree-l2"><a class="reference internal" href="installation-apache.html">Apache</a></li>
    573. 

  573. <li class="toctree-l2"><a class="reference internal" href="update-searxng.html">SearXNG maintenance</a></li>
    574. 

  574. <li class="toctree-l2"><a class="reference internal" href="answer-captcha.html">Answer CAPTCHA from server’s IP</a></li>
    575. 

  575. <li class="toctree-l2"><a class="reference internal" href="searx.favicons.html">Favicons</a></li>
    576. 

  576. <li class="toctree-l2"><a class="reference internal" href="searx.limiter.html">Limiter</a></li>
    577. 

  577. <li class="toctree-l2"><a class="reference internal" href="api.html">Administration API</a></li>
    578. 

  578. <li class="toctree-l2"><a class="reference internal" href="architecture.html">Architecture</a></li>
    579. 

  579. <li class="toctree-l2"><a class="reference internal" href="plugins.html">List of plugins</a></li>
    580. 

  580. <li class="toctree-l2"><a class="reference internal" href="buildhosts.html">Buildhosts</a></li>
    581. 

  581. </ul>
    582. 

  582. </li>
    583. 

  583. <li class="toctree-l1"><a class="reference internal" href="../dev/index.html">Developer documentation</a></li>
    584. 

  584. <li class="toctree-l1"><a class="reference internal" href="../utils/index.html">DevOps tooling box</a></li>
    585. 

  585. <li class="toctree-l1"><a class="reference internal" href="../src/index.html">Source-Code</a></li>
    586. 

  586. </ul>
    587. 

  587. 

  588.   <h3>Project Links</h3>
    589. 

  589.   <ul>
    590. 

  590.     <li><a href="https://github.com/searxng/searxng/tree/master">Source</a>
    591. 

  591.   
    592. 

  592.     <li><a href="https://github.com/searxng/searxng/wiki">Wiki</a>
    593. 

  593.   
    594. 

  594.     <li><a href="https://searx.space">Public instances</a>
    595. 

  595.   
    596. 

  596.     <li><a href="https://github.com/searxng/searxng/issues">Issue Tracker</a>
    597. 

  597.   </ul><h3>Navigation</h3>
    598. 

  598. <ul>
    599. 

  599.   <li><a href="../index.html">Overview</a>
    600. 

  600.     <ul>
    601. 

  601.       <li><a href="index.html">Administrator documentation</a>
    602. 

  602.         <ul>
    603. 

  603.           <li>Previous: <a href="installation-searxng.html" title="previous chapter">Step by step installation</a>
    604. 

  604.           <li>Next: <a href="installation-nginx.html" title="next chapter">NGINX</a></ul>
    605. 

  605.       </li>
    606. 

  606.     </ul>
    607. 

  607.   </li>
    608. 

  608. </ul>
    609. 

  609. <search id="searchbox" style="display: none" role="search">
    610. 

  610.   <h3 id="searchlabel">Quick search</h3>
    611. 

  611.     <div class="searchformwrapper">
    612. 

  612.     <form class="search" action="../search.html" method="get">
    613. 

  613.       <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
    614. 

  614.       <input type="submit" value="Go" />
    615. 

  615.     </form>
    616. 

  616.     </div>
    617. 

  617. </search>
    618. 

  618. <script>document.getElementById('searchbox').style.display = "block"</script>
    619. 

  619.   <div role="note" aria-label="source link">
    620. 

  620.     <h3>This Page</h3>
    621. 

  621.     <ul class="this-page-menu">
    622. 

  622.       <li><a href="../_sources/admin/installation-uwsgi.rst.txt"
    623. 

  623.             rel="nofollow">Show Source</a></li>
    624. 

  624.     </ul>
    625. 

  625.    </div>
    626. 

  626.         </div>
    627. 

  627.       </div>
    628. 

  628.       <div class="clearer"></div>
    629. 

  629.     </div>
    630. 

  630.     <div class="footer" role="contentinfo">
    631. 

  631.     &#169; Copyright SearXNG team.
    632. 

  632.     </div>
    633. 

  633.   </body>
    634. 

  634. </html>
    635.
© 2025 NTab仓库
Page: 78ms Template: 1ms 微信 微信二维码 哔哩哔哩 Sina Weibo Javascript Licenses Website