summaryrefslogtreecommitdiff
path: root/docs/admin/installation-docker.rst
blob: 7e40546c6e7fc897ed5daa9ad2d9a258f8413d32 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.. _installation docker:

===================
Docker installation
===================

.. contents:: Contents
   :depth: 2
   :local:
   :backlinks: entry

----

Docker image searxng/searxng
============================


The docker image is `searxng/searxng <https://hub.docker.com/r/searxng/searxng>`_ (based on `github.com/searxng/searxng <https://github.com/searxng/searxng>`_).

Make sure you have `installed Docker <https://docs.docker.com/get-docker/>`_.  For instance, you can deploy a local instance:

.. code:: sh

    export PORT=80
    docker pull searxng/searxng
    docker run --rm -d -v ${PWD}/searx:/etc/searx -p $PORT:8080 -e BASE_URL=http://localhost:$PORT/ searxng/searxng

Go to ``http://localhost:$PORT``.

Inside ``${PWD}/searx``, you will find ``settings.yml`` and ``uwsgi.ini``.
You can modify these files according to your needs  and restart the Docker image.


Command line
------------


.. code:: sh

    docker run --rm -it searxng/searxng -h

.. program-output:: ../dockerfiles/docker-entrypoint.sh -h


Build the image
---------------

It's also possible to build SearXNG from the embedded Dockerfile.

.. code:: sh

   git clone https://github.com/searxng/searxng.git
   cd searx
   make docker.build


Public instance
===============

If you intend to create a public instance using Docker, see https://github.com/searx/searx-docker