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

lxcdev.html 48 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465 
  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>Developing in Linux Containers &#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="Makefile &amp; ./manage" href="makefile.html" />
    20. 

  20.     <link rel="prev" title="Translation" href="translation.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="makefile.html" title="Makefile &amp; ./manage"
    33. 

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

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

  35.           <a href="translation.html" title="Translation"
    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">Developer documentation</a> &#187;</li>
    39. 

  39.         <li class="nav-item nav-item-this"><a href="">Developing in Linux Containers</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="developing-in-linux-containers">
    49. 

  49. <span id="lxcdev"></span><h1>Developing in Linux Containers<a class="headerlink" href="#developing-in-linux-containers" title="Link to this heading">¶</a></h1>
    50. 

  50. <p>In this article we will show, how you can make use of Linux Containers (<a class="reference external" href="https://linuxcontainers.org/lxc/introduction/">LXC</a>) in
    51. 

  51. <em>distributed and heterogeneous development cycles</em> (TL;DR; jump to the
    52. 

  52. <a class="reference internal" href="#lxcdev-summary"><span class="std std-ref">Summary</span></a>).</p>
    53. 

  53. <aside class="sidebar">
    54. 

  54. <p class="sidebar-title">Audience</p>
    55. 

  55. <p>This blog post is written for experienced admins and developers.  Readers
    56. 

  56. should have a serious meaning about the terms: <em>distributed</em>, <em>merge</em> and
    57. 

  57. <em>linux container</em>.</p>
    58. 

  58. <p><strong>hint</strong></p>
    59. 

  59. <p>If you have issues with the internet connectivity of your containers read
    60. 

  60. section <a class="reference internal" href="../utils/lxc.sh.html#internet-connectivity-docker"><span class="std std-ref">Internet Connectivity &amp; Docker</span></a>.</p>
    61. 

  61. </aside>
    62. 

  62. <nav class="contents local" id="contents">
    63. 

  63. <ul class="simple">
    64. 

  64. <li><p><a class="reference internal" href="#motivation" id="id1">Motivation</a></p></li>
    65. 

  65. <li><p><a class="reference internal" href="#gentlemen-start-your-engines" id="id2">Gentlemen, start your engines!</a></p></li>
    66. 

  66. <li><p><a class="reference internal" href="#in-containers-work-as-usual" id="id3">In containers, work as usual</a></p></li>
    67. 

  67. <li><p><a class="reference internal" href="#wrap-production-into-developer-suite" id="id4">Wrap production into developer suite</a></p></li>
    68. 

  68. <li><p><a class="reference internal" href="#summary" id="id5">Summary</a></p></li>
    69. 

  69. </ul>
    70. 

  70. </nav>
    71. 

  71. <section id="motivation">
    72. 

  72. <h2><a class="toc-backref" href="#id1" role="doc-backlink">Motivation</a><a class="headerlink" href="#motivation" title="Link to this heading">¶</a></h2>
    73. 

  73. <p>Most often in our development cycle, we edit the sources and run some test
    74. 

  74. and/or builds by using <code class="docutils literal notranslate"><span class="pre">make</span></code> <a class="reference internal" href="makefile.html#makefile"><span class="std std-ref">[ref]</span></a> before we commit.  This
    75. 

  75. cycle is simple and perfect but might fail in some aspects we should not
    76. 

  76. overlook.</p>
    77. 

  77. <blockquote>
    78. 

  78. <div><p><strong>The environment in which we run all our development processes matters!</strong></p>
    79. 

  79. </div></blockquote>
    80. 

  80. <p>The <a class="reference internal" href="makefile.html#makefile"><span class="std std-ref">Makefile &amp; ./manage</span></a> and the <a class="reference internal" href="makefile.html#make-install"><span class="std std-ref">Python environment (make install)</span></a> encapsulate a lot for us, but
    81. 

  81. these tools do not have access to all prerequisites.  For example, there may
    82. 

  82. have dependencies on packages that are installed on developer’s desktop, but
    83. 

  83. usually are not preinstalled on a server or client system.  Another example is;
    84. 

  84. settings have been made to the software on developer’s desktop that would never
    85. 

  85. be set on a <em>production</em> system.</p>
    86. 

  86. <blockquote>
    87. 

  87. <div><p><strong>Linux Containers are isolate environments</strong>, we use them to not mix up all
    88. 

  88. the prerequisites from various projects on developer’s desktop.</p>
    89. 

  89. </div></blockquote>
    90. 

  90. <p>The scripts from <a class="reference internal" href="../utils/index.html#searx-utils"><span class="std std-ref">DevOps tooling box</span></a> can divide in those to install and maintain
    91. 

  91. software</p>
    92. 

  92. <ul class="simple">
    93. 

  93. <li><p><a class="reference internal" href="../utils/searxng.sh.html#searxng-sh"><span class="std std-ref">utils/searxng.sh</span></a></p></li>
    94. 

  94. </ul>
    95. 

  95. <p>and the script</p>
    96. 

  96. <ul class="simple">
    97. 

  97. <li><p><a class="reference internal" href="../utils/lxc.sh.html#lxc-sh"><span class="std std-ref">utils/lxc.sh</span></a></p></li>
    98. 

  98. </ul>
    99. 

  99. <p>with we can scale our installation, maintenance or even development tasks over a
    100. 

  100. stack of isolated containers / what we call the:</p>
    101. 

  101. <ul class="simple">
    102. 

  102. <li><p><a class="reference internal" href="../utils/lxc.sh.html#searxng-lxc-suite"><span class="std std-ref">SearXNG LXC suite</span></a></p></li>
    103. 

  103. </ul>
    104. 

  104. </section>
    105. 

  105. <section id="gentlemen-start-your-engines">
    106. 

  106. <span id="lxcdev-install-searxng"></span><h2><a class="toc-backref" href="#id2" role="doc-backlink">Gentlemen, start your engines!</a><a class="headerlink" href="#gentlemen-start-your-engines" title="Link to this heading">¶</a></h2>
    107. 

  107. <p>Before you can start with containers, you need to install and initiate <a class="reference external" href="https://linuxcontainers.org/lxd/introduction/">LXD</a>
    108. 

  108. once:</p>
    109. 

  109. <div class="sphinx-tabs docutils container">
    110. 

  110. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-0-ZGVza3RvcCAoSE9TVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-0-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="0">desktop (HOST)</button></div><div aria-labelledby="tab-0-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" id="panel-0-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>snap<span class="w"> </span>install<span class="w"> </span>lxd
    111. 

  111. $<span class="w"> </span>lxd<span class="w"> </span>init<span class="w"> </span>--auto
    112. 

  112. </pre></div>
    113. 

  113. </div>
    114. 

  114. </div></div>
    115. 

  115. <p>And you need to clone from origin or if you have your own fork, clone from your
    116. 

  116. fork:</p>
    117. 

  117. <div class="sphinx-tabs docutils container">
    118. 

  118. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-1-ZGVza3RvcCAoSE9TVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-1-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="0">desktop (HOST)</button></div><div aria-labelledby="tab-1-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" id="panel-1-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span><span class="nb">cd</span><span class="w"> </span>~/Downloads
    119. 

  119. $<span class="w"> </span>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/searxng/searxng.git<span class="w"> </span>searxng
    120. 

  120. $<span class="w"> </span><span class="nb">cd</span><span class="w"> </span>searxng
    121. 

  121. </pre></div>
    122. 

  122. </div>
    123. 

  123. </div></div>
    124. 

  124. <aside class="sidebar">
    125. 

  125. <p class="sidebar-title">The <code class="docutils literal notranslate"><span class="pre">searxng-archlinux</span></code> container</p>
    126. 

  126. <p>is the base of all our exercises here.</p>
    127. 

  127. </aside>
    128. 

  128. <p>The <a class="reference internal" href="../utils/lxc.sh.html#lxc-searxng-env"><span class="std std-ref">SearXNG suite config</span></a> consists of several images, see <code class="docutils literal notranslate"><span class="pre">export</span>
    129. 

  129. <span class="pre">LXC_SUITE=(...</span></code> near by <a class="extlink-origin reference external" href="https://github.com/searxng/searxng/blob/master/utils/lxc-searxng.env#L19">git://utils/lxc-searxng.env#L19</a>.
    130. 

  130. For this blog post we exercise on a <a class="reference external" href="https://www.archlinux.org/">archlinux</a> image.  The container of this
    131. 

  131. image is named <code class="docutils literal notranslate"><span class="pre">searxng-archlinux</span></code>.</p>
    132. 

  132. <p>Lets build the container, but be sure that this container does not already
    133. 

  133. exists, so first lets remove possible old one:</p>
    134. 

  134. <div class="sphinx-tabs docutils container">
    135. 

  135. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-2-ZGVza3RvcCAoSE9TVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-2-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="0">desktop (HOST)</button></div><div aria-labelledby="tab-2-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" id="panel-2-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>remove<span class="w"> </span>searxng-archlinux
    136. 

  136. $<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>build<span class="w"> </span>searxng-archlinux
    137. 

  137. </pre></div>
    138. 

  138. </div>
    139. 

  139. </div></div>
    140. 

  140. <aside class="sidebar">
    141. 

  141. <p class="sidebar-title">further read</p>
    142. 

  142. <ul class="simple">
    143. 

  143. <li><p><a class="reference internal" href="../utils/lxc.sh.html#lxc-sh-install-suite"><span class="std std-ref">Install suite</span></a></p></li>
    144. 

  144. <li><p><a class="reference internal" href="../admin/installation-nginx.html#installation-nginx"><span class="std std-ref">NGINX</span></a></p></li>
    145. 

  145. </ul>
    146. 

  146. </aside>
    147. 

  147. <p>To install the complete <a class="reference internal" href="../utils/lxc.sh.html#searxng-lxc-suite"><span class="std std-ref">SearXNG suite</span></a> and the HTTP
    148. 

  148. proxy <a class="reference internal" href="../admin/installation-nginx.html#installation-nginx"><span class="std std-ref">NGINX</span></a> into the archlinux container run:</p>
    149. 

  149. <div class="sphinx-tabs docutils container">
    150. 

  150. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-3-ZGVza3RvcCAoSE9TVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-3-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="0">desktop (HOST)</button></div><div aria-labelledby="tab-3-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" id="panel-3-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>install<span class="w"> </span>suite<span class="w"> </span>searxng-archlinux
    151. 

  151. $<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>--<span class="w"> </span><span class="nv">FORCE_TIMEOUT</span><span class="o">=</span><span class="m">0</span><span class="w"> </span>./utils/searxng.sh<span class="w"> </span>install<span class="w"> </span>nginx
    152. 

  152. $<span class="w"> </span>sudo<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>show<span class="w"> </span>suite<span class="w"> </span><span class="p">|</span><span class="w"> </span>grep<span class="w"> </span>SEARXNG_URL
    153. 

  153. ...
    154. 

  154. <span class="o">[</span>searxng-archlinux<span class="o">]</span><span class="w">    </span>SEARXNG_URL<span class="w">          </span>:<span class="w"> </span>http://n.n.n.140/searxng
    155. 

  155. </pre></div>
    156. 

  156. </div>
    157. 

  157. </div></div>
    158. 

  158. <aside class="sidebar">
    159. 

  159. <p class="sidebar-title">Fully functional SearXNG suite</p>
    160. 

  160. <p>From here on you have a fully functional SearXNG suite (including a
    161. 

  161. <a class="reference internal" href="../src/searx.redisdb.html#redis-db"><span class="std std-ref">Redis DB</span></a>).</p>
    162. 

  162. </aside>
    163. 

  163. <p>In such a SearXNG suite admins can maintain and access the debug log of the
    164. 

  164. services quite easy.</p>
    165. 

  165. <p>In the example above the SearXNG instance in the container is wrapped to
    166. 

  166. <code class="docutils literal notranslate"><span class="pre">http://n.n.n.140/searxng</span></code> to the HOST system.  Note, on your HOST system, the
    167. 

  167. IP of your <code class="docutils literal notranslate"><span class="pre">searxng-archlinux</span></code> container is different to this example.  To
    168. 

  168. test the instance in the container from outside of the container, in your WEB
    169. 

  169. browser on your desktop just open the URL reported in your installation</p>
    170. 

  170. </section>
    171. 

  171. <section id="in-containers-work-as-usual">
    172. 

  172. <span id="working-in-containers"></span><h2><a class="toc-backref" href="#id3" role="doc-backlink">In containers, work as usual</a><a class="headerlink" href="#in-containers-work-as-usual" title="Link to this heading">¶</a></h2>
    173. 

  173. <p>Usually you open a root-bash using <code class="docutils literal notranslate"><span class="pre">sudo</span> <span class="pre">-H</span> <span class="pre">bash</span></code>.  In case of LXC containers
    174. 

  174. open the root-bash in the container is done by the <code class="docutils literal notranslate"><span class="pre">./utils/lxc.sh</span> <span class="pre">cmd</span>
    175. 

  175. <span class="pre">searxng-archlinux</span></code> command:</p>
    176. 

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

  177. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-4-ZGVza3RvcCAoSE9TVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-4-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="0">desktop (HOST)</button></div><div aria-labelledby="tab-4-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" id="panel-4-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>bash
    178. 

  178. INFO:<span class="w">  </span><span class="o">[</span>searxng-archlinux<span class="o">]</span><span class="w"> </span>bash
    179. 

  179. <span class="o">[</span>root@searxng-archlinux<span class="w"> </span>SearXNG<span class="o">]</span>$
    180. 

  180. </pre></div>
    181. 

  181. </div>
    182. 

  182. </div></div>
    183. 

  183. <p>The prompt <code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">...]</span></code> signals, that you are the root user
    184. 

  184. in the container (GUEST).  To debug the running SearXNG instance use:</p>
    185. 

  185. <div class="sphinx-tabs docutils container">
    186. 

  186. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-5-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-5-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-5-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-5-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-5-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-5-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>instance<span class="w"> </span>inspect
    187. 

  187. ...
    188. 

  188. use<span class="w"> </span><span class="o">[</span>CTRL-C<span class="o">]</span><span class="w"> </span>to<span class="w"> </span>stop<span class="w"> </span>monitoring<span class="w"> </span>the<span class="w"> </span>log
    189. 

  189. ...
    190. 

  190. </pre></div>
    191. 

  191. </div>
    192. 

  192. </div><div aria-labelledby="tab-5-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-5-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>instance<span class="w"> </span>inspect
    193. 

  193. ...
    194. 

  194. use<span class="w"> </span><span class="o">[</span>CTRL-C<span class="o">]</span><span class="w"> </span>to<span class="w"> </span>stop<span class="w"> </span>monitoring<span class="w"> </span>the<span class="w"> </span>log
    195. 

  195. ...
    196. 

  196. </pre></div>
    197. 

  197. </div>
    198. 

  198. </div></div>
    199. 

  199. <p>Back in the browser on your desktop open the service <a class="reference external" href="http://n.n.n.140/searxng">http://n.n.n.140/searxng</a>
    200. 

  200. and run your application tests while the debug log is shown in the terminal from
    201. 

  201. above.  You can stop monitoring using <code class="docutils literal notranslate"><span class="pre">CTRL-C</span></code>, this also disables the <em>“debug
    202. 

  202. option”</em> in SearXNG’s settings file and restarts the SearXNG uwsgi application.</p>
    203. 

  203. <p>Another point we have to notice is that the service <a class="reference internal" href="../utils/searxng.sh.html#searxng-sh"><span class="std std-ref">SearXNG</span></a>
    204. 

  204. runs under dedicated system user account with the same name (compare
    205. 

  205. <a class="reference internal" href="../admin/installation-searxng.html#create-searxng-user"><span class="std std-ref">Create user</span></a>).  To get a login shell from these accounts, simply
    206. 

  206. call:</p>
    207. 

  207. <div class="sphinx-tabs docutils container">
    208. 

  208. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-6-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-6-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-6-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-6-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-6-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-6-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>instance<span class="w"> </span>cmd<span class="w"> </span>bash<span class="w"> </span>-l
    209. 

  209. <span class="o">(</span>searx-pyenv<span class="o">)</span><span class="w"> </span><span class="o">[</span>searxng@searxng-archlinux<span class="w"> </span>~<span class="o">]</span>$<span class="w"> </span><span class="nb">pwd</span>
    210. 

  210. /usr/local/searxng
    211. 

  211. </pre></div>
    212. 

  212. </div>
    213. 

  213. </div><div aria-labelledby="tab-6-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-6-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>instance<span class="w"> </span>cmd<span class="w"> </span>bash<span class="w"> </span>-l
    214. 

  214. INFO:<span class="w">  </span><span class="o">[</span>searxng-archlinux<span class="o">]</span><span class="w"> </span>./utils/searxng.sh<span class="w"> </span>instance<span class="w"> </span>cmd<span class="w"> </span>bash<span class="w"> </span>-l
    215. 

  215. <span class="o">(</span>searx-pyenv<span class="o">)</span><span class="w"> </span><span class="o">[</span>searxng@searxng-archlinux<span class="w"> </span>~<span class="o">]</span>$<span class="w"> </span><span class="nb">pwd</span>
    216. 

  216. /usr/local/searxng
    217. 

  217. </pre></div>
    218. 

  218. </div>
    219. 

  219. </div></div>
    220. 

  220. <p>The prompt <code class="docutils literal notranslate"><span class="pre">[searxng&#64;searxng-archlinux]</span></code> signals that you are logged in as system
    221. 

  221. user <code class="docutils literal notranslate"><span class="pre">searxng</span></code> in the <code class="docutils literal notranslate"><span class="pre">searxng-archlinux</span></code> container and the python <em>virtualenv</em>
    222. 

  222. <code class="docutils literal notranslate"><span class="pre">(searxng-pyenv)</span></code> environment is activated.</p>
    223. 

  223. </section>
    224. 

  224. <section id="wrap-production-into-developer-suite">
    225. 

  225. <h2><a class="toc-backref" href="#id4" role="doc-backlink">Wrap production into developer suite</a><a class="headerlink" href="#wrap-production-into-developer-suite" title="Link to this heading">¶</a></h2>
    226. 

  226. <p>In this section we will see how to change the <em>“Fully functional SearXNG suite”</em>
    227. 

  227. from a LXC container (which is quite ready for production) into a developer
    228. 

  228. suite.  For this, we have to keep an eye on the <a class="reference internal" href="../admin/installation-searxng.html#installation-basic"><span class="std std-ref">Step by step installation</span></a>:</p>
    229. 

  229. <ul class="simple">
    230. 

  230. <li><p>SearXNG setup in: <code class="docutils literal notranslate"><span class="pre">/etc/searxng/settings.yml</span></code></p></li>
    231. 

  231. <li><p>SearXNG user’s home: <code class="docutils literal notranslate"><span class="pre">/usr/local/searxng</span></code></p></li>
    232. 

  232. <li><p>virtualenv in: <code class="docutils literal notranslate"><span class="pre">/usr/local/searxng/searxng-pyenv</span></code></p></li>
    233. 

  233. <li><p>SearXNG software in: <code class="docutils literal notranslate"><span class="pre">/usr/local/searxng/searxng-src</span></code></p></li>
    234. 

  234. </ul>
    235. 

  235. <p>With the use of the <a class="reference internal" href="../utils/searxng.sh.html#searxng-sh"><span class="std std-ref">utils/searxng.sh</span></a> the SearXNG service was installed as
    236. 

  236. <a class="reference internal" href="../admin/installation-uwsgi.html#searxng-uwsgi"><span class="std std-ref">uWSGI application</span></a>.  To maintain this service, we can use
    237. 

  237. <code class="docutils literal notranslate"><span class="pre">systemctl</span></code> (compare <a class="reference internal" href="../admin/installation-uwsgi.html#uwsgi-maintenance"><span class="std std-ref">uWSGI maintenance</span></a>).</p>
    238. 

  238. <div class="sphinx-tabs docutils container">
    239. 

  239. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-7-dXdzZ2lAc2VhcnhuZw==" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-7-dXdzZ2lAc2VhcnhuZw==" name="dXdzZ2lAc2VhcnhuZw==" role="tab" tabindex="0"><a class="reference external" href="mailto:uwsgi&#37;&#52;&#48;searxng">uwsgi<span>&#64;</span>searxng</a></button></div><div aria-labelledby="tab-7-dXdzZ2lAc2VhcnhuZw==" class="sphinx-tabs-panel group-tab" id="panel-7-dXdzZ2lAc2VhcnhuZw==" name="dXdzZ2lAc2VhcnhuZw==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>systemctl<span class="w"> </span>stop<span class="w"> </span>uwsgi@searxng
    240. 

  240. </pre></div>
    241. 

  241. </div>
    242. 

  242. </div></div>
    243. 

  243. <p>With the command above, we stopped the SearXNG uWSGI-App in the archlinux
    244. 

  244. container.</p>
    245. 

  245. <p>The uWSGI-App for the archlinux distros is configured in
    246. 

  246. <a class="extlink-origin reference external" href="https://github.com/searxng/searxng/blob/master/utils/templates/etc/uwsgi/apps-archlinux/searxng.ini">git://utils/templates/etc/uwsgi/apps-archlinux/searxng.ini</a>, from where at
    247. 

  247. least you should attend the settings of <code class="docutils literal notranslate"><span class="pre">uid</span></code>, <code class="docutils literal notranslate"><span class="pre">chdir</span></code>, <code class="docutils literal notranslate"><span class="pre">env</span></code> and
    248. 

  248. <code class="docutils literal notranslate"><span class="pre">http</span></code>:</p>
    249. 

  249. <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">env</span> <span class="o">=</span> <span class="n">SEARXNG_SETTINGS_PATH</span><span class="o">=/</span><span class="n">etc</span><span class="o">/</span><span class="n">searxng</span><span class="o">/</span><span class="n">settings</span><span class="o">.</span><span class="n">yml</span>
    250. 

  250. <span class="n">http</span> <span class="o">=</span> <span class="mf">127.0.0.1</span><span class="p">:</span><span class="mi">8888</span>
    251. 

  251. 

  252. <span class="n">chdir</span> <span class="o">=</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">searxng</span><span class="o">/</span><span class="n">searxng</span><span class="o">-</span><span class="n">src</span><span class="o">/</span><span class="n">searx</span>
    253. 

  253. <span class="n">virtualenv</span> <span class="o">=</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">searxng</span><span class="o">/</span><span class="n">searxng</span><span class="o">-</span><span class="n">pyenv</span>
    254. 

  254. <span class="n">pythonpath</span> <span class="o">=</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">searxng</span><span class="o">/</span><span class="n">searxng</span><span class="o">-</span><span class="n">src</span>
    255. 

  255. </pre></div>
    256. 

  256. </div>
    257. 

  257. <p>If you have read the <a class="reference internal" href="../utils/lxc.sh.html#good-to-know"><span class="std std-ref">Good to know</span></a> you remember, that each container
    258. 

  258. shares the root folder of the repository and the command <code class="docutils literal notranslate"><span class="pre">utils/lxc.sh</span> <span class="pre">cmd</span></code>
    259. 

  259. handles relative path names <strong>transparent</strong>.</p>
    260. 

  260. <p>To wrap the SearXNG installation in the container into a developer one, we
    261. 

  261. simple have to create a symlink to the <strong>transparent</strong> repository from the
    262. 

  262. desktop.  Now lets replace the repository at <code class="docutils literal notranslate"><span class="pre">searxng-src</span></code> in the container
    263. 

  263. with the working tree from outside of the container:</p>
    264. 

  264. <div class="sphinx-tabs docutils container">
    265. 

  265. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-8-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-8-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-8-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-8-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-8-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-8-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>mv<span class="w"> </span>/usr/local/searxng/searxng-src<span class="w">  </span>/usr/local/searxng/searxng-src.old
    266. 

  266. $<span class="w"> </span>ln<span class="w"> </span>-s<span class="w"> </span>/share/SearXNG/<span class="w"> </span>/usr/local/searxng/searxng-src
    267. 

  267. </pre></div>
    268. 

  268. </div>
    269. 

  269. </div><div aria-labelledby="tab-8-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-8-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span><span class="se">\</span>
    270. 

  270. <span class="w">  </span>mv<span class="w"> </span>/usr/local/searxng/searxng-src<span class="w"> </span>/usr/local/searxng/searxng-src.old
    271. 

  271. 

  272. $<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span><span class="se">\</span>
    273. 

  273. <span class="w">  </span>ln<span class="w"> </span>-s<span class="w"> </span>/share/SearXNG/<span class="w"> </span>/usr/local/searxng/searxng-src
    274. 

  274. </pre></div>
    275. 

  275. </div>
    276. 

  276. </div></div>
    277. 

  277. <p>Now we can develop as usual in the working tree of our desktop system.  Every
    278. 

  278. time the software was changed, you have to restart the SearXNG service (in the
    279. 

  279. container):</p>
    280. 

  280. <div class="sphinx-tabs docutils container">
    281. 

  281. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-9-dXdzZ2lAc2VhcnhuZw==" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-9-dXdzZ2lAc2VhcnhuZw==" name="dXdzZ2lAc2VhcnhuZw==" role="tab" tabindex="0"><a class="reference external" href="mailto:uwsgi&#37;&#52;&#48;searxng">uwsgi<span>&#64;</span>searxng</a></button></div><div aria-labelledby="tab-9-dXdzZ2lAc2VhcnhuZw==" class="sphinx-tabs-panel group-tab" id="panel-9-dXdzZ2lAc2VhcnhuZw==" name="dXdzZ2lAc2VhcnhuZw==" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>systemctl<span class="w"> </span>restart<span class="w"> </span>uwsgi@searxng
    282. 

  282. </pre></div>
    283. 

  283. </div>
    284. 

  284. </div></div>
    285. 

  285. <p>Remember: <a class="reference internal" href="#working-in-containers"><span class="std std-ref">In containers, work as usual</span></a> .. here are just some examples from my
    286. 

  286. daily usage:</p>
    287. 

  287. <p>To <em>inspect</em> the SearXNG instance (already described above):</p>
    288. 

  288. <div class="sphinx-tabs docutils container">
    289. 

  289. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-10-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-10-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-10-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-10-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-10-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-10-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>./utils/searx.sh<span class="w"> </span>inspect<span class="w"> </span>service
    290. 

  290. </pre></div>
    291. 

  291. </div>
    292. 

  292. </div><div aria-labelledby="tab-10-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-10-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>./utils/searx.sh<span class="w"> </span>inspect<span class="w"> </span>service
    293. 

  293. </pre></div>
    294. 

  294. </div>
    295. 

  295. </div></div>
    296. 

  296. <p>Run <a class="reference internal" href="makefile.html#makefile"><span class="std std-ref">Makefile &amp; ./manage</span></a>, e.g. to test inside the container:</p>
    297. 

  297. <div class="sphinx-tabs docutils container">
    298. 

  298. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-11-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-11-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-11-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-11-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-11-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-11-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>make<span class="w"> </span><span class="nb">test</span>
    299. 

  299. </pre></div>
    300. 

  300. </div>
    301. 

  301. </div><div aria-labelledby="tab-11-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-11-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w">  </span>make<span class="w"> </span><span class="nb">test</span>
    302. 

  302. </pre></div>
    303. 

  303. </div>
    304. 

  304. </div></div>
    305. 

  305. <p>To install all prerequisites needed for a <a class="reference internal" href="../admin/buildhosts.html#buildhosts"><span class="std std-ref">Buildhosts</span></a>:</p>
    306. 

  306. <div class="sphinx-tabs docutils container">
    307. 

  307. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-12-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-12-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-12-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-12-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-12-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-12-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>install<span class="w"> </span>buildhost
    308. 

  308. </pre></div>
    309. 

  309. </div>
    310. 

  310. </div><div aria-labelledby="tab-12-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-12-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>./utils/searxng.sh<span class="w"> </span>install<span class="w"> </span>buildhost
    311. 

  311. </pre></div>
    312. 

  312. </div>
    313. 

  313. </div></div>
    314. 

  314. <p>To build the docs on a buildhost <a class="reference internal" href="../admin/buildhosts.html#buildhosts"><span class="std std-ref">Buildhosts</span></a>:</p>
    315. 

  315. <div class="sphinx-tabs docutils container">
    316. 

  316. <div aria-label="Tabbed content" class="closeable" role="tablist"><button aria-controls="panel-13-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" aria-selected="true" class="sphinx-tabs-tab group-tab" id="tab-13-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tab" tabindex="0"><code class="docutils literal notranslate"><span class="pre">[root&#64;searxng-archlinux</span> <span class="pre">SearXNG]</span></code> (GUEST)</button><button aria-controls="panel-13-ZGVza3RvcCAoSE9TVCk=" aria-selected="false" class="sphinx-tabs-tab group-tab" id="tab-13-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tab" tabindex="-1">desktop (HOST)</button></div><div aria-labelledby="tab-13-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" class="sphinx-tabs-panel group-tab" id="panel-13-YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" name="YGBbcm9vdEBzZWFyeG5nLWFyY2hsaW51eCBTZWFyWE5HXWBgIChHVUVTVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>make<span class="w"> </span>docs.html
    317. 

  317. </pre></div>
    318. 

  318. </div>
    319. 

  319. </div><div aria-labelledby="tab-13-ZGVza3RvcCAoSE9TVCk=" class="sphinx-tabs-panel group-tab" hidden="true" id="panel-13-ZGVza3RvcCAoSE9TVCk=" name="ZGVza3RvcCAoSE9TVCk=" role="tabpanel" tabindex="0"><div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>make<span class="w"> </span>docs.html
    320. 

  320. </pre></div>
    321. 

  321. </div>
    322. 

  322. </div></div>
    323. 

  323. </section>
    324. 

  324. <section id="summary">
    325. 

  325. <span id="lxcdev-summary"></span><h2><a class="toc-backref" href="#id5" role="doc-backlink">Summary</a><a class="headerlink" href="#summary" title="Link to this heading">¶</a></h2>
    326. 

  326. <p>We build up a fully functional SearXNG suite in a archlinux container:</p>
    327. 

  327. <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>build<span class="w"> </span>searxng-archlinux
    328. 

  328. $<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>install<span class="w"> </span>suite<span class="w"> </span>searxng-archlinux
    329. 

  329. ...
    330. 

  330. Developer<span class="w"> </span>install?<span class="w"> </span><span class="o">(</span>wraps<span class="w"> </span><span class="nb">source</span><span class="w"> </span>from<span class="w"> </span>HOST<span class="w"> </span>into<span class="w"> </span>the<span class="w"> </span>running<span class="w"> </span>instance<span class="o">)</span><span class="w"> </span><span class="o">[</span>YES/no<span class="o">]</span>
    331. 

  331. </pre></div>
    332. 

  332. </div>
    333. 

  333. <p>To wrap the suite into a developer one answer <code class="docutils literal notranslate"><span class="pre">YES</span></code> (or press Enter).</p>
    334. 

  334. <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>link SearXNG&#39;s sources to: /share/SearXNG
    335. 

  335. =========================================
    336. 

  336. 

  337. mv -f &quot;/usr/local/searxng/searxng-src&quot; &quot;/usr/local/searxng/searxng-src.backup&quot;
    338. 

  338. ln -s &quot;/share/SearXNG&quot; &quot;/usr/local/searxng/searxng-src&quot;
    339. 

  339. ls -ld /usr/local/searxng/searxng-src
    340. 

  340.   |searxng| lrwxrwxrwx 1 searxng searxng ... /usr/local/searxng/searxng-src -&gt; /share/SearXNG
    341. 

  341. </pre></div>
    342. 

  342. </div>
    343. 

  343. <p>On code modification the instance has to be restarted (see <a class="reference internal" href="../admin/installation-uwsgi.html#uwsgi-maintenance"><span class="std std-ref">uWSGI maintenance</span></a>):</p>
    344. 

  344. <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>searxng-archlinux<span class="w"> </span>systemctl<span class="w"> </span>restart<span class="w"> </span>uwsgi@searxng
    345. 

  345. </pre></div>
    346. 

  346. </div>
    347. 

  347. <p>To access HTTP from the desktop we installed nginx for the services inside the
    348. 

  348. container:</p>
    349. 

  349. <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sudo<span class="w"> </span>-H<span class="w"> </span>./utils/lxc.sh<span class="w"> </span>cmd<span class="w"> </span>--<span class="w"> </span><span class="nv">FORCE_TIMEOUT</span><span class="o">=</span><span class="m">0</span><span class="w"> </span>./utils/searxng.sh<span class="w"> </span>install<span class="w"> </span>nginx
    350. 

  350. </pre></div>
    351. 

  351. </div>
    352. 

  352. <p>To get information about the SearxNG suite in the archlinux container we can
    353. 

  353. use:</p>
    354. 

  354. <div class="highlight-text notranslate"><div class="highlight"><pre><span></span>$ sudo -H ./utils/lxc.sh show suite searxng-archlinux
    355. 

  355. [searxng-archlinux]  INFO:  (eth0) docs-live:  http:///n.n.n.140:8080/
    356. 

  356. [searxng-archlinux]  INFO:  (eth0) IPv6:       http://[fd42:555b:2af9:e121:216:3eff:fe5b:1744]
    357. 

  357. [searxng-archlinux]  uWSGI:
    358. 

  358. [searxng-archlinux]    SEARXNG_UWSGI_SOCKET : /usr/local/searxng/run/socket
    359. 

  359. [searxng-archlinux]  environment /usr/local/searxng/searxng-src/utils/brand.env:
    360. 

  360. [searxng-archlinux]    GIT_URL              : https://github.com/searxng/searxng
    361. 

  361. [searxng-archlinux]    GIT_BRANCH           : master
    362. 

  362. [searxng-archlinux]    SEARXNG_URL          : http:///n.n.n.140/searxng
    363. 

  363. [searxng-archlinux]    SEARXNG_PORT         : 8888
    364. 

  364. [searxng-archlinux]    SEARXNG_BIND_ADDRESS : 127.0.0.1
    365. 

  365. </pre></div>
    366. 

  366. </div>
    367. 

  367. </section>
    368. 

  368. </section>
    369. 

  369. 

  370. 

  371.             <div class="clearer"></div>
    372. 

  372.           </div>
    373. 

  373.         </div>
    374. 

  374.       </div>
    375. 

  375.   <span id="sidebar-top"></span>
    376. 

  376.       <div class="sphinxsidebar" role="navigation" aria-label="Main">
    377. 

  377.         <div class="sphinxsidebarwrapper">
    378. 

  378.   
    379. 

  379.     
    380. 

  380.             <p class="logo"><a href="../index.html">
    381. 

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

  382.             </a></p>
    383. 

  383.   
    384. 

  384. 

  385. <h3><a href="../index.html">Table of Contents</a></h3>
    386. 

  386. <ul class="current">
    387. 

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

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

  389. <li class="toctree-l1"><a class="reference internal" href="../admin/index.html">Administrator documentation</a></li>
    390. 

  390. <li class="toctree-l1 current"><a class="reference internal" href="index.html">Developer documentation</a><ul class="current">
    391. 

  391. <li class="toctree-l2"><a class="reference internal" href="quickstart.html">Development Quickstart</a></li>
    392. 

  392. <li class="toctree-l2"><a class="reference internal" href="rtm_asdf.html">Runtime Management</a></li>
    393. 

  393. <li class="toctree-l2"><a class="reference internal" href="contribution_guide.html">How to contribute</a></li>
    394. 

  394. <li class="toctree-l2"><a class="reference internal" href="extended_types.html">Extended Types</a></li>
    395. 

  395. <li class="toctree-l2"><a class="reference internal" href="engines/index.html">Engine Implementations</a></li>
    396. 

  396. <li class="toctree-l2"><a class="reference internal" href="result_types/index.html">Result Types</a></li>
    397. 

  397. <li class="toctree-l2"><a class="reference internal" href="templates.html">Simple Theme Templates</a></li>
    398. 

  398. <li class="toctree-l2"><a class="reference internal" href="search_api.html">Search API</a></li>
    399. 

  399. <li class="toctree-l2"><a class="reference internal" href="plugins/index.html">Plugins</a></li>
    400. 

  400. <li class="toctree-l2"><a class="reference internal" href="answerers/index.html">Answerers</a></li>
    401. 

  401. <li class="toctree-l2"><a class="reference internal" href="translation.html">Translation</a></li>
    402. 

  402. <li class="toctree-l2 current"><a class="current reference internal" href="#">Developing in Linux Containers</a><ul>
    403. 

  403. <li class="toctree-l3"><a class="reference internal" href="#motivation">Motivation</a></li>
    404. 

  404. <li class="toctree-l3"><a class="reference internal" href="#gentlemen-start-your-engines">Gentlemen, start your engines!</a></li>
    405. 

  405. <li class="toctree-l3"><a class="reference internal" href="#in-containers-work-as-usual">In containers, work as usual</a></li>
    406. 

  406. <li class="toctree-l3"><a class="reference internal" href="#wrap-production-into-developer-suite">Wrap production into developer suite</a></li>
    407. 

  407. <li class="toctree-l3"><a class="reference internal" href="#summary">Summary</a></li>
    408. 

  408. </ul>
    409. 

  409. </li>
    410. 

  410. <li class="toctree-l2"><a class="reference internal" href="makefile.html">Makefile &amp; <code class="docutils literal notranslate"><span class="pre">./manage</span></code></a></li>
    411. 

  411. <li class="toctree-l2"><a class="reference internal" href="reST.html">reST primer</a></li>
    412. 

  412. <li class="toctree-l2"><a class="reference internal" href="searxng_extra/index.html">Tooling box <code class="docutils literal notranslate"><span class="pre">searxng_extra</span></code></a></li>
    413. 

  413. </ul>
    414. 

  414. </li>
    415. 

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

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

  417. </ul>
    418. 

  418. 

  419.   <h3>Project Links</h3>
    420. 

  420.   <ul>
    421. 

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

  422.   
    423. 

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

  424.   
    425. 

  425.     <li><a href="https://searx.space">Public instances</a>
    426. 

  426.   
    427. 

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

  428.   </ul><h3>Navigation</h3>
    429. 

  429. <ul>
    430. 

  430.   <li><a href="../index.html">Overview</a>
    431. 

  431.     <ul>
    432. 

  432.       <li><a href="index.html">Developer documentation</a>
    433. 

  433.         <ul>
    434. 

  434.           <li>Previous: <a href="translation.html" title="previous chapter">Translation</a>
    435. 

  435.           <li>Next: <a href="makefile.html" title="next chapter">Makefile &amp; <code class="docutils literal notranslate"><span class="pre">./manage</span></code></a></ul>
    436. 

  436.       </li>
    437. 

  437.     </ul>
    438. 

  438.   </li>
    439. 

  439. </ul>
    440. 

  440. <search id="searchbox" style="display: none" role="search">
    441. 

  441.   <h3 id="searchlabel">Quick search</h3>
    442. 

  442.     <div class="searchformwrapper">
    443. 

  443.     <form class="search" action="../search.html" method="get">
    444. 

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

  445.       <input type="submit" value="Go" />
    446. 

  446.     </form>
    447. 

  447.     </div>
    448. 

  448. </search>
    449. 

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

  450.   <div role="note" aria-label="source link">
    451. 

  451.     <h3>This Page</h3>
    452. 

  452.     <ul class="this-page-menu">
    453. 

  453.       <li><a href="../_sources/dev/lxcdev.rst.txt"
    454. 

  454.             rel="nofollow">Show Source</a></li>
    455. 

  455.     </ul>
    456. 

  456.    </div>
    457. 

  457.         </div>
    458. 

  458.       </div>
    459. 

  459.       <div class="clearer"></div>
    460. 

  460.     </div>
    461. 

  461.     <div class="footer" role="contentinfo">
    462. 

  462.     &#169; Copyright SearXNG team.
    463. 

  463.     </div>
    464. 

  464.   </body>
    465. 

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