2020-01-06 15:33:58 +01:00
<!DOCTYPE html>
2020-06-19 11:15:15 +02:00
< html >
2020-01-06 15:33:58 +01:00
< head >
< meta charset = "utf-8" / >
2020-09-30 10:35:05 +02:00
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" / >
2020-01-06 15:33:58 +01:00
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
2021-03-27 20:39:04 +01:00
< title > Docker installation — Searx Documentation (Searx-1.0.0.tex)< / title >
2020-01-06 15:33:58 +01:00
< link rel = "stylesheet" href = "../_static/pygments.css" type = "text/css" / >
2021-01-05 16:45:49 +01:00
< link rel = "stylesheet" href = "../_static/searx.css" type = "text/css" / >
2021-02-17 20:54:37 +01:00
< link rel = "stylesheet" type = "text/css" href = "../_static/tabs.css" / >
2020-02-15 10:08:58 +01:00
< script id = "documentation_options" data-url_root = "../" src = "../_static/documentation_options.js" > < / script >
< script src = "../_static/jquery.js" > < / script >
< script src = "../_static/underscore.js" > < / script >
< script src = "../_static/doctools.js" > < / script >
2020-01-06 15:33:58 +01:00
< link rel = "index" title = "Index" href = "../genindex.html" / >
< link rel = "search" title = "Search" href = "../search.html" / >
2020-06-19 11:15:15 +02:00
< link rel = "next" title = "How to update" href = "update-searx.html" / >
< link rel = "prev" title = "Install with apache" href = "installation-apache.html" / >
2020-01-06 15:33:58 +01:00
< / head > < body >
< div class = "related" role = "navigation" aria-label = "related navigation" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
2020-11-04 14:12:59 +01:00
< li class = "right" >
< a href = "../py-modindex.html" title = "Python Module Index"
>modules< / a > |< / li >
2020-06-19 11:15:15 +02:00
< li class = "right" >
< a href = "update-searx.html" title = "How to update"
accesskey="N">next< / a > |< / li >
< li class = "right" >
< a href = "installation-apache.html" title = "Install with apache"
accesskey="P">previous< / a > |< / li >
2021-03-27 20:39:04 +01:00
< li class = "nav-item nav-item-0" > < a href = "../index.html" > Searx Documentation (Searx-1.0.0.tex)< / a > » < / li >
2020-09-30 10:35:05 +02:00
< li class = "nav-item nav-item-1" > < a href = "index.html" accesskey = "U" > Administrator documentation< / a > » < / li >
< li class = "nav-item nav-item-this" > < a href = "" > Docker installation< / a > < / li >
2020-01-06 15:33:58 +01:00
< / ul >
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" role = "main" >
2021-04-08 19:47:22 +02:00
< div class = "section" id = "docker-installation" >
2020-06-19 11:15:15 +02:00
< span id = "installation-docker" > < / span > < h1 > Docker installation< a class = "headerlink" href = "#docker-installation" title = "Permalink to this headline" > ¶< / a > < / h1 >
2020-07-25 18:33:36 +02:00
< div class = "contents local topic" id = "contents" >
< p class = "topic-title" > Contents< / p >
< ul class = "simple" >
< li > < p > < a class = "reference internal" href = "#docker-image-searx-searx" id = "id1" > Docker image searx/searx< / a > < / p >
< ul >
< li > < p > < a class = "reference internal" href = "#command-line" id = "id2" > Command line< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#build-the-image" id = "id3" > Build the image< / a > < / p > < / li >
< / ul >
< / li >
< li > < p > < a class = "reference internal" href = "#public-instance" id = "id4" > Public instance< / a > < / p > < / li >
< / ul >
< / div >
< hr class = "docutils" / >
2021-04-08 19:47:22 +02:00
< div class = "section" id = "docker-image-searx-searx" >
2020-07-25 18:33:36 +02:00
< h2 > < a class = "toc-backref" href = "#id1" > Docker image searx/searx< / a > < a class = "headerlink" href = "#docker-image-searx-searx" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > The docker image is < a class = "reference external" href = "https://hub.docker.com/r/searx/searx" > searx/searx< / a > (based on < a class = "reference external" href = "https://github.com/searx/searx" > github.com/searx/searx< / a > ).< / p >
< p > Make sure you have < a class = "reference external" href = "https://docs.docker.com/get-docker/" > installed Docker< / a > . For instance, you can deploy a local instance:< / p >
2021-03-16 11:09:10 +01:00
< div class = "highlight-sh notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nb" > export< / span > < span class = "nv" > PORT< / span > < span class = "o" > =< / span > < span class = "m" > 80< / span >
2020-07-25 18:33:36 +02:00
docker pull searx/searx
docker run --rm -d -v < span class = "si" > ${< / span > < span class = "nv" > PWD< / span > < span class = "si" > }< / span > /searx:/etc/searx -p < span class = "nv" > $PORT< / span > :8080 -e < span class = "nv" > BASE_URL< / span > < span class = "o" > =< / span > http://localhost:< span class = "nv" > $PORT< / span > / searx/searx
2020-06-19 11:15:15 +02:00
< / pre > < / div >
< / div >
< p > Go to < code class = "docutils literal notranslate" > < span class = "pre" > http://localhost:$PORT< / span > < / code > .< / p >
2020-07-25 18:33:36 +02:00
< p > Inside < code class = "docutils literal notranslate" > < span class = "pre" > ${PWD}/searx< / span > < / code > , you will find < code class = "docutils literal notranslate" > < span class = "pre" > settings.yml< / span > < / code > and < code class = "docutils literal notranslate" > < span class = "pre" > uwsgi.ini< / span > < / code > .
You can modify these files according to your needs and restart the Docker image.< / p >
2021-04-08 19:47:22 +02:00
< div class = "section" id = "command-line" >
2020-07-25 18:33:36 +02:00
< h3 > < a class = "toc-backref" href = "#id2" > Command line< / a > < a class = "headerlink" href = "#command-line" title = "Permalink to this headline" > ¶< / a > < / h3 >
< div class = "highlight-sh notranslate" > < div class = "highlight" > < pre > < span > < / span > docker run --rm -it searx/searx -h
< / pre > < / div >
< / div >
< div class = "highlight-text notranslate" > < div class = "highlight" > < pre > < span > < / span > Command line:
-h Display this help
-d Dry run to update the configuration files.
-f Always update on the configuration files (existing files are renamed with the .old suffix)
Without this option, the new configuration files are copied with the .new suffix
Environment variables:
INSTANCE_NAME settings.yml : general.instance_name
AUTOCOMPLETE settings.yml : search.autocomplete
BASE_URL settings.yml : server.base_url
MORTY_URL settings.yml : result_proxy.url
MORTY_KEY settings.yml : result_proxy.key
2020-09-30 10:35:05 +02:00
BIND_ADDRESS uwsgi bind to the specified TCP socket using HTTP protocol. Default value: " 0.0.0.0:8080"
2020-07-25 18:33:36 +02:00
Volume:
/etc/searx the docker entry point copies settings.yml and uwsgi.ini in this directory (see the -f command line option)
< / pre > < / div >
< / div >
2021-04-08 19:47:22 +02:00
< / div >
< div class = "section" id = "build-the-image" >
2020-07-25 18:33:36 +02:00
< h3 > < a class = "toc-backref" href = "#id3" > Build the image< / a > < a class = "headerlink" href = "#build-the-image" title = "Permalink to this headline" > ¶< / a > < / h3 >
< p > It’ s also possible to build searx from the embedded Dockerfile.< / p >
2020-09-30 10:35:05 +02:00
< div class = "highlight-sh notranslate" > < div class = "highlight" > < pre > < span > < / span > git clone https://github.com/searx/searx.git
2020-06-19 11:15:15 +02:00
< span class = "nb" > cd< / span > searx
2021-04-23 19:02:01 +02:00
make docker.build
2020-06-19 11:15:15 +02:00
< / pre > < / div >
< / div >
2021-04-08 19:47:22 +02:00
< / div >
< / div >
< div class = "section" id = "public-instance" >
2020-07-25 18:33:36 +02:00
< h2 > < a class = "toc-backref" href = "#id4" > Public instance< / a > < a class = "headerlink" href = "#public-instance" title = "Permalink to this headline" > ¶< / a > < / h2 >
< p > If you intend to create a public instance using Docker, see < a class = "reference external" href = "https://github.com/searx/searx-docker" > https://github.com/searx/searx-docker< / a > < / p >
2021-04-08 19:47:22 +02:00
< / div >
< / div >
2020-01-06 15:33:58 +01:00
2020-09-30 10:35:05 +02:00
< div class = "clearer" > < / div >
2020-01-06 15:33:58 +01:00
< / div >
< / div >
< / div >
< span id = "sidebar-top" > < / span >
< div class = "sphinxsidebar" role = "navigation" aria-label = "main navigation" >
< div class = "sphinxsidebarwrapper" >
< p class = "logo" > < a href = "../index.html" >
< img class = "logo" src = "../_static/searx_logo_small.png" alt = "Logo" / >
< / a > < / p >
< h3 > Project Links< / h3 >
< ul >
2020-09-30 10:35:05 +02:00
< li > < a href = "https://github.com/searx/searx" > Source< / a >
2020-01-06 15:33:58 +01:00
2020-09-30 10:35:05 +02:00
< li > < a href = "https://github.com/searx/searx/wiki" > Wiki< / a >
2020-01-06 15:33:58 +01:00
2021-01-12 10:55:12 +01:00
< li > < a href = "https://searx.space" > Public instances< / a >
2020-01-06 15:33:58 +01:00
< li > < a href = "https://twitter.com/Searx_engine" > Twitter< / a >
2021-01-12 10:55:12 +01:00
< li > < a href = "https://github.com/searx/searx/issues" > Issue Tracker< / a >
2020-01-06 15:33:58 +01:00
< / ul > < h3 > Navigation< / h3 >
< ul >
< li > < a href = "../index.html" > Overview< / a >
2020-06-19 11:15:15 +02:00
< ul >
< li > < a href = "index.html" > Administrator documentation< / a >
< ul >
< li > Previous: < a href = "installation-apache.html" title = "previous chapter" > Install with apache< / a >
< li > Next: < a href = "update-searx.html" title = "next chapter" > How to update< / a > < / ul >
< / li >
< / ul >
2020-01-06 15:33:58 +01:00
< / li >
< / ul >
< div id = "searchbox" style = "display: none" role = "search" >
< h3 id = "searchlabel" > Quick search< / h3 >
< div class = "searchformwrapper" >
< form class = "search" action = "../search.html" method = "get" >
< input type = "text" name = "q" aria-labelledby = "searchlabel" / >
< input type = "submit" value = "Go" / >
< / form >
< / div >
< / div >
2020-02-15 10:08:58 +01:00
< script > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
2020-01-06 15:33:58 +01:00
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "footer" role = "contentinfo" >
2020-02-20 19:32:55 +01:00
© Copyright 2015-2020, Adam Tauber, Noémi Ványi.
2021-04-23 18:56:27 +02:00
Created using < a href = "https://www.sphinx-doc.org/" > Sphinx< / a > 3.5.4.
2020-01-06 15:33:58 +01:00
< / div >
2020-02-15 10:08:58 +01:00
< script src = "../_static/version_warning_offset.js" > < / script >
2020-01-06 15:33:58 +01:00
< / body >
< / html >